ASP.NET Core EF Core数据库优先模式下替换默认Id为自定义UserId

针对你遇到的控制器参数接收UserId为空的问题，可通过以下步骤解决：

1. 确认模型主键配置有效性 #

虽然已在UsersModel上标记[Key]属性，但需确保属性定义正确，且未被数据库优先的代码生成工具覆盖：

public class UsersModel
{
    [Key]
    public Guid UserId { get; set; }
    // 其他属性...
}

若使用EF Core脚手架生成模型，检查生成的代码是否保留了[Key]特性，避免重新生成时被覆盖。

2. 匹配控制器参数与前端传递的参数名 #

ASP.NET Core模型绑定依赖参数名称匹配，需确保前端传递的键名与控制器参数名一致（大小写不敏感，但建议保持统一）：

路由参数场景 #

控制器方法定义：

public IActionResult UserDetails(Guid userId)
{
    var user = _context.Users.Find(userId);
    return View(user);
}

对应路由配置需包含userId占位符：

app.MapControllerRoute(
    name: "UserDetails",
    pattern: "users/{userId}",
    defaults: new { controller = "Users", action = "UserDetails" });

前端链接写法：

<a href="/users/@user.UserId">查看用户详情</a>

表单/POST请求场景 #

表单输入框的name属性需设为userId：

<form asp-action="UpdateUser" method="post">
    <input type="hidden" name="userId" value="@Model.UserId" />
    <!-- 其他表单字段 -->
    <button type="submit">保存</button>
</form>

控制器方法可通过[FromForm]明确绑定来源（可选，默认会自动匹配）：

[HttpPost]
public IActionResult UpdateUser(Guid userId, string userName)
{
    var user = _context.Users.Find(userId);
    if (user != null)
    {
        user.UserName = userName;
        _context.SaveChanges();
    }
    return RedirectToAction("Index");
}

3. 显式配置EF Core主键约定 #

EF Core默认优先识别Id或[实体名]Id作为主键，即使标记了[Key]，也可在DbContext中显式配置主键，彻底覆盖默认约定：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<UsersModel>()
        .HasKey(u => u.UserId);
    // 其他实体配置
}

4. 验证前端传递的Guid格式 #

确保前端传递的UserId是有效的Guid字符串，避免包含空格、特殊字符等无效格式，否则模型绑定会失败导致参数为空。若通过AJAX传递，需保证JSON键名与参数名一致：

fetch('/users/update', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ userId: '@Model.UserId', userName: '新用户名' })
});

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