ASP.NET Core中如何将Enum枚举作为字符串参数传给[Authorize]特性？

问题根源 #

原生[Authorize]特性的Roles参数仅接受字符串类型输入，不支持直接传入枚举值，因此会触发类型转换报错。

解决方案 #

方案1：快速修复（无需额外封装）

使用nameof关键字在编译期将枚举成员转换为对应的字符串常量即可，写法如下：

[Authorize(Roles = nameof(Role.Admin))]
[HttpGet]
public IActionResult GetAll()
{
     var users = _userService.GetAll();
     return Ok(users);
}

该方案的优势是既保留了枚举的类型安全特性（如果枚举成员名写错编译会直接报错），又不需要额外编写自定义代码。

方案2：自定义授权特性（适合频繁使用枚举角色的场景）

你可以封装一个继承自AuthorizeAttribute的自定义特性，直接接收枚举作为入参，内部自动完成类型转换：

// 自定义授权特性
public class AuthorizeRoleAttribute : AuthorizeAttribute
{
    public AuthorizeRoleAttribute(Role role)
    {
        Roles = role.ToString();
    }
}

封装完成后直接在控制器方法上使用即可，写法更简洁直观：

[AuthorizeRole(Role.Admin)]
[HttpGet]
public IActionResult GetAll()
{
     var users = _userService.GetAll();
     return Ok(users);
}

注意事项 #

请确认你在_jwtUtils.GenerateJwtToken(user)生成JWT令牌的逻辑中，添加角色声明时已经将枚举转成了字符串格式，示例如下：

// 生成JWT时添加角色声明的正确写法
new Claim(ClaimTypes.Role, user.Role.ToString())

如果角色声明的值和[Authorize]特性中传入的字符串不匹配，会导致授权校验失败。

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