ASP.NET Core 2.2 MVC应用中NLog.Web.AspNetCore布局渲染器为空问题

我来帮你排查这个问题——你遇到的${aspnet-request-url}和${aspnet-mvc-action}返回空值的情况，通常是因为NLog无法正确访问ASP.NET Core的HttpContext，或者集成配置有遗漏。结合你的配置，我整理了几个关键修复步骤：

1. 注册HttpContextAccessor服务 #

ASP.NET Core 2.x默认不会自动注册IHttpContextAccessor，而NLog的ASP.NET Core布局渲染器依赖这个服务来获取请求上下文。在Startup.cs的ConfigureServices方法中添加：

services.AddHttpContextAccessor();

2. 完善Program.cs中的NLog集成 #

你目前只在AddLogging中添加了NLog，但还需要在WebHost构建时启用NLog的ASP.NET Core集成，确保它能绑定到请求上下文。修改Program.cs：

public class Program
{
    public static void Main(string[] args)
    {
        // 初始化NLog并加载配置
        var logger = NLog.Web.NLogBuilder.ConfigureNLog("nlog.config").GetCurrentClassLogger();
        try
        {
            logger.Debug("应用启动中");
            BuildWebHost(args).Run();
        }
        catch (Exception ex)
        {
            logger.Error(ex, "应用因异常终止");
            throw;
        }
        finally
        {
            // 关闭NLog释放资源
            NLog.LogManager.Shutdown();
        }
    }

    public static IWebHost BuildWebHost(string[] args) =>
        WebHost.CreateDefaultBuilder(args)
            .UseStartup<Startup>()
            .ConfigureLogging(logging =>
            {
                logging.ClearProviders();
                logging.SetMinimumLevel(LogLevel.Trace);
            })
            .UseNLog() // 关键：启用NLog的ASP.NET Core集成
            .Build();
}

3. 确认日志的记录时机 #

如果你的日志是在控制器构造函数中记录的，此时HttpContext还未初始化，布局渲染器自然返回空值。确保日志是在Action方法内部记录的，比如：

public class ConfigController : Controller
{
    private readonly ILogger<ConfigController> _logger;

    public ConfigController(ILogger<ConfigController> logger)
    {
        _logger = logger;
        // ❌ 这里记录日志会导致空值，因为HttpContext还没准备好
        // _logger.LogInformation("构造函数日志");
    }

    public IActionResult Index()
    {
        // ✅ 这里记录日志能正确获取HttpContext
        _logger.LogInformation("访问Index Action");
        return View();
    }
}

4. 检查NLog内部日志排查问题 #

你已经开启了NLog的内部日志（internalLogLevel="Trace"），可以打开c:\temp\internal-nlog.txt查看是否有错误信息，比如：

• 找不到aspnet-request-url布局渲染器（说明NLog.Web.AspNetCore扩展未正确加载）
• 无法访问HttpContext的相关警告

如果看到扩展加载失败，尝试重新安装NuGet包，你的NLog 4.6.2、NLog.Extensions.Logging 1.4.0、NLog.Web.AspNetCore 4.8.1版本组合是兼容的，无需调整版本。

按照以上步骤调整后，应该就能正常输出url和action信息了。

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