Skip to content

Upgrading FluentValidation 10 to 11

Breaking10.4.0 → 11.12.0Breaking7Deprecated12New36Changed34Fixed32Other4

Full comparisonBack to FluentValidation
BreakingUpgrade verdict

7 breaking changes.

In plain terms
  • The old OnFailure and OnAnyFailure callbacks are gone; use the newer equivalents.
  • The old ASP.NET setting for running default MVC validation after FluentValidation is removed.
  • The old Options property on RuleComponent is removed.
  • Old testing helper methods that were marked deprecated are removed.
Must act Top 5 of 19 that need code or config changes

Target frameworks requirement changed in 11.9.0: .NETStandard2.0, .NETStandard2.1, net5.0, net6.0 → .NETStandard2.0, .NETStandard2.1, net5.0, net6.0, net7.0, net8.0.

Adds system.threading.tasks.extensions 4.5.4.

What you must change

Breaking7
Removes the deprecated OnFailure/OnAnyFailure callbacks.
OnFailureOnAnyFailure
11.0.1GitHub ReleaseSummarizedView source
Removes the deprecated RunDefaultMvcValidationAfterFluentValidationExecutes option from the ASP.NET integration.
RunDefaultMvcValidationAfterFluentValidationExecutes
11.0.1GitHub ReleaseSummarizedView source
Removes the deprecated Options property from RuleComponent.
RuleComponent.OptionsRuleComponent
11.0.1GitHub ReleaseSummarizedView source
Removes deprecated TestHelper methods.
TestHelper
11.0.1GitHub ReleaseSummarizedView source
Removes the non-generic PropertyValidator backwards compatibility layer.
PropertyValidator
11.0.1GitHub ReleaseSummarizedView source
Throws exceptions when an async validator is invoked synchronously.
11.0.2GitHub ReleaseSummarizedView source
Throws exceptions when an async validator is invoked synchronously.
11.0.1GitHub ReleaseSummarizedView source

Deprecations to plan for

Deprecated12
Deprecates disabling the root model null check by overriding AbstractValidator.EnsureInstanceNotNull.
AbstractValidator.EnsureInstanceNotNull
11.5.1GitHub ReleaseSummarizedView source
Deprecates the Transform and TransformAsync methods.
TransformTransformAsync
11.5.1GitHub ReleaseSummarizedView source
Deprecates the ScalePrecision validator and introduces PrecisionScale as its replacement.
ScalePrecisionPrecisionScale
11.5.0GitHub ReleaseSummarizedView source
Deprecates the ScalePrecision validator and introduces PrecisionScale as its replacement.
ScalePrecisionPrecisionScale
11.4.0GitHub ReleaseSummarizedView source
Deprecates implicit validation of child properties in MVC auto validation.
11.3.0GitHub ReleaseSummarizedView source
Deprecates implicit validation of root collection elements in MVC auto validation.
11.3.0GitHub ReleaseSummarizedView source
Deprecates InjectValidator.
InjectValidator
11.3.0GitHub ReleaseSummarizedView source
Deprecates IValidatorFactory and ServiceProviderValidatorFactory.
IValidatorFactoryServiceProviderValidatorFactory
11.3.0GitHub ReleaseSummarizedView source
Deprecates implicit validation of child properties in MVC auto validation.
11.1.0GitHub ReleaseSummarizedView source
Deprecates implicit validation of root collection elements in MVC auto validation.
11.1.0GitHub ReleaseSummarizedView source
Deprecates InjectValidator.
InjectValidator
11.1.0GitHub ReleaseSummarizedView source
Deprecates IValidatorFactory and ServiceProviderValidatorFactory.
IValidatorFactoryServiceProviderValidatorFactory
11.1.0GitHub ReleaseSummarizedView source