.NET Core中使用UrlHelper构建分页链接时遇uriString空值错误

这个错误我之前也踩过坑，问题根源出在你注册IUrlHelper的方式上——直接通过IActionContextAccessor获取ActionContext时，在构造函数注入这类场景下，请求上下文还没完成初始化，导致UrlHelper实例拿到的是null上下文，后续生成链接时自然会抛出uriString为空的异常。

正确的IUrlHelper注册方式 #

别再手动实例化UrlHelper了，改用框架提供的IUrlHelperFactory来创建实例，它会自动处理上下文的有效性。修改你的Startup配置：

services.AddSingleton<IActionContextAccessor, ActionContextAccessor>();
// 替换原来的IUrlHelper注册逻辑
services.AddScoped<IUrlHelper>(factory =>
{
    var actionContext = factory.GetRequiredService<IActionContextAccessor>().ActionContext 
                        ?? throw new InvalidOperationException("当前无可用的ActionContext，请确保在请求上下文内使用IUrlHelper");
    return factory.GetRequiredService<IUrlHelperFactory>().GetUrlHelper(actionContext);
});

在分页链接类中正确使用 #

如果你是在自定义分页类里使用IUrlHelper，注意不要在构造函数里直接生成链接（此时请求上下文可能还未就绪），而是在处理请求的方法中调用：

public class PaginationLinkBuilder
{
    private readonly IUrlHelper _urlHelper;

    // 注入IUrlHelper
    public PaginationLinkBuilder(IUrlHelper urlHelper)
    {
        _urlHelper = urlHelper;
    }

    public string BuildNextPageLink(int currentPage, int pageSize, int totalItems)
    {
        if (currentPage * pageSize >= totalItems)
            return null;

        // 注意：确保你的控制器路由有明确的名称（比如[HttpGet(Name = "GetItems")]）
        return _urlHelper.Link("GetItems", new 
        { 
            page = currentPage + 1, 
            pageSize = pageSize 
        });
    }
}

额外注意事项 #

• 控制器的路由必须设置明确的Name属性，这样UrlHelper.Link才能精准匹配到目标路由；
• 如果是在非请求上下文（比如后台任务）中使用IUrlHelper，需要手动构建ActionContext，但分页链接一般都是在请求响应中生成，这种场景很少见。

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