ASP.NET调用GetRolesAsync读取用户角色报RuntimeBinderException如何解决

错误现象 #

基于ASP.NET开发工单系统Admin Panel读取用户角色时，运行时抛出如下异常：

Microsoft.CSharp.RuntimeBinder.RuntimeBinderException: "'System.Threading.Tasks.Task<System.Collections.Generic.IList>' does not contain a definition for 'ToList'"

出错代码如下：

public List<String> getRols(dynamic user)
{
    return _UserManager.GetRolesAsync(user).ToList();
}

根因 #

两个问题直接触发异常：

• GetRolesAsync是异步方法，返回值为Task<IList<string>>，并非直接返回角色列表。你直接在Task实例上调用ToList()，而Task类型本身不存在该扩展方法。
• 入参定义为dynamic关闭了编译期类型检查，导致这个类型不匹配的问题没有在编译阶段暴露，拖到运行时才以动态绑定异常的形式抛出。

修复方案 #

推荐：按异步规范改写（符合ASP.NET Identity设计约定） #

将方法改为异步签名，使用await等待任务返回实际结果后再做类型转换，同时移除不必要的dynamic入参，替换为你项目使用的用户实体类型（通常是继承自IdentityUser的自定义用户类，例如AppUser）：

// 顺带修正了原方法名的拼写错误：Rols -> Roles
public async Task<List<string>> GetRoles(AppUser user)
{
    var roleList = await _UserManager.GetRolesAsync(user);
    return roleList.ToList();
}

注意所有调用该方法的位置，都需要添加await关键字等待结果。

不推荐：同步阻塞写法（仅兼容旧逻辑临时使用） #

如果当前上下文无法改造为异步调用，可以通过.Result获取Task的执行结果后再转List，该写法在ASP.NET请求上下文中存在死锁风险，非必要不要用：

public List<string> GetRoles(dynamic user)
{
    return _UserManager.GetRolesAsync(user).Result.ToList();
}

排查要点 #

• 所有带Async后缀的方法，先检查是否正确使用await等待，确认拿到的是实际业务返回值而非Task包装对象
• 无明确动态类型需求时不要滥用dynamic，会丢失编译期类型校验，大幅提升运行时排错成本
• 遇到“某类型不存在某方法”的异常时，先核对抛出异常的类型是否和预期操作的类型一致，可快速定位包装类、转换逻辑的问题。

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