.NET Core 5 Web API中[Remote]远程验证特性不生效如何解决

核心问题出在控制器基类选择、路由匹配、前置依赖缺失三个方向，按以下步骤排查修复： #

1. 修正验证控制器实现 #

[Remote]是MVC视图专属的验证组件，不能放在继承ControllerBase的API控制器中：

• 将ValidationController从Api层迁移到MVC Web层的Controllers目录
• 控制器改为继承Controller（而非Web API用的ControllerBase），不要加[ApiController]特性
• 接口返回值使用MVC内置的Json()方法，保证序列化规则符合验证组件要求

修正后的控制器代码：

public class ValidationController : Controller
{
    [AllowAnonymous]
    [AcceptVerbs("Get", "Post")]
    public IActionResult IsCompanyValid(decimal CompanyId) // 参数名和实体属性名保持一致，避免大小写匹配失败
    {
        // 返回true = 验证通过；返回false/字符串 = 验证失败，字符串内容为自定义错误提示
        bool isCompanyExist = false; // 替换为你的实际业务校验逻辑
        if (!isCompanyExist)
        {
            return Json("输入的运输公司ID不存在");
        }
        return Json(true);
    }
}

2. 修正实体[Remote]特性配置 #

明确指定路由参数和请求方式，避免路由匹配失败：

[Remote(
    action: "IsCompanyValid", 
    controller: "Validation", 
    HttpMethod = "Post", 
    ErrorMessage = "运输公司ID校验失败"
)]
[DisplayName("شناسه شرکت حمل و نقل")]
[Required(ErrorMessage = "{0} الزامی می باشد.")]
[Range(1, maximum: MaxValue, ErrorMessage = "{0} می تواند بین {1} تا {2} باشد.")]      
public decimal CompanyId { get; set; }

3. 补全前端验证依赖脚本 #

[Remote]客户端验证依赖jQuery Unobtrusive Validation组件，必须在表单所在视图引入以下脚本，否则不会触发验证请求：

<script src="~/lib/jquery/dist/jquery.min.js"></script>
<script src="~/lib/jquery-validation/dist/jquery.validate.min.js"></script>
<script src="~/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.min.js"></script>

4. 检查MVC服务配置 #

在Program.cs中确认MVC服务没有关闭客户端验证开关：

builder.Services.AddControllersWithViews()
    .AddViewOptions(options =>
    {
        // 两个开关必须保持为true，默认值就是true，如果你之前手动设为false就会导致验证失效
        options.HtmlHelperOptions.ClientValidationEnabled = true;
        options.HtmlHelperOptions.UnobtrusiveJavaScriptEnabled = true;
    });

排查验证 #

修复后打开浏览器F12开发者工具，在CompanyId输入框输入值后失焦，查看网络面板：

• 没有发向/Validation/IsCompanyValid的请求：检查脚本是否加载成功、表单输入框是否有data-val-remote相关属性
• 请求返回404：检查控制器路由是否配置正确、控制器是否放在MVC项目可扫描的目录下
• 请求返回400：检查参数名是否和接口参数名一致，不要给接口参数加[FromBody]特性
• 请求返回200但验证不生效：检查返回值格式，必须是标准JSON格式的布尔值或字符串，不能包裹其他自定义响应结构

内容的提问来源于stack exchange，提问作者MiladKardgar