.NET5 MVC调用Url.Action抛出helper参数为null异常如何解决

问题根因 #

你遇到的Value cannot be null. (Parameter 'helper')异常，本质是ControllerBase自带的Url属性为null。Url.Action是IUrlHelper的扩展方法，扩展方法的第一个入参就是调用该方法的实例本身，也就是这里的Url对象，当Url为null时调用扩展方法就会抛出这个异常，不是你需要手动给Action方法多传第一个参数。
Url属性默认只会在MVC请求管道正常触发Controller动作时自动初始化，如果你手动实例化Controller、或者在请求管道之外调用该方法，Url就会为null。

解决方案 #

步骤1：注册依赖服务 #

在你的.NET 5项目Startup.cs的ConfigureServices方法中添加以下服务注册：

services.AddSingleton<IActionContextAccessor, ActionContextAccessor>();

步骤2：在Controller中注入并初始化IUrlHelper #

在你的Controller构造函数中注入IUrlHelperFactory和IActionContextAccessor，手动生成可靠的IUrlHelper实例：

public class YourController : ControllerBase
{
    private readonly IUrlHelper _urlHelper;

    // 构造函数注入依赖
    public YourController(IUrlHelperFactory urlHelperFactory, IActionContextAccessor actionContextAccessor)
    {
        _urlHelper = urlHelperFactory.GetUrlHelper(actionContextAccessor.ActionContext);
    }

    // 修改后的Uri生成方法
    public Uri UriUrlBuilder(string actionName, string controllerName, int? port)
    {
        try
        {
            UriBuilder uriBuilder = new()
            {
                Host = AppSettings.BaseURL,
                Scheme = "https",
                // 修复port为null时的强转异常，https默认端口为443
                Port = port ?? 443,
                // 用手动初始化的_urlHelper替代原生Url属性
                Path = _urlHelper.Action(actionName, controllerName)
            };
            return uriBuilder.Uri;
        }
        catch (Exception ex)
        {
            _ = new LogWriter("Class: Common. Method: UriUrlBuilder.  Error: " + ex.Message);
            return null;
        }
    }
}

额外优化建议 #

• 不要在方法内直接new AppSettingsConfiguration()，建议通过依赖注入注入IOptions配置实例，避免配置重复加载、读取失败的问题。
• 可以补充对actionName、controllerName的空值校验，提前拦截非法入参。

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