MicroElements配置的FluentValidation规则未在Swagger显示如何排查

架构老林

2026-9-27

FluentValidation规则未同步到Swagger UI的排查步骤

确认FluentValidation校验器已注册到DI容器
MicroElements库需要从DI容器中读取校验器实例，需提前注册所有校验器，可通过如下代码批量注册当前程序集内的所有校验器：
```
services.AddValidatorsFromAssemblyContaining<FooValidator>();
```

显式指定MicroElements的扫描程序集
避免库默认扫描逻辑遗漏校验器所在程序集，注册时显式传入程序集参数：

services.AddFluentValidationRulesToSwagger(opt =>
{
    opt.AssembliesToScan = new[] { typeof(FooValidator).Assembly };
    // 如需将NotEmpty规则对应字段标记为必填，可补充配置
    opt.SetNotNullableAsRequired = true;
});

核对Swashbuckle基础配置
检查项目是否开启可空引用类型支持（项目文件中<Nullable>enable</Nullable>），同时在AddSwaggerGen中开启可空类型支持：

services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "FooProject", Version = "v1" });
    c.IncludeXmlComments(XmlCommentsFilePath);
    // 新增可空引用类型支持
    c.SupportNonNullableReferenceTypes();
});

校验类型匹配关系
确认FooValidator继承的AbstractValidator<T>泛型参数确实是FooDTO，不存在不同命名空间下的同名DTO类型导致匹配错误。
排查启动日志和冲突
将日志级别调整为Debug，启动项目查看控制台是否有MicroElements相关的告警、报错信息，确认是否存在其他Swagger Schema过滤器和MicroElements的规则产生冲突。
区分内置规则和自定义规则
Must方法定义的自定义校验规则默认无法被MicroElements识别，不会同步到Swagger属于正常现象，优先验证NotEmpty等内置规则是否能正常展示，排除核心注册逻辑问题。
核对依赖包版本匹配
确认安装的是MicroElements.Swashbuckle.FluentValidation包，且版本和当前使用的Swashbuckle.AspNetCore主版本兼容，避免跨版本不兼容问题。