ASP.NET Core用NLog经Azure DevOps部署到Azure WebApp后无法生成日志的问题

我之前在部署ASP.NET Core应用到Azure WebApp时也碰到过完全一样的NLog日志不生成的问题，结合Azure的环境特性，给你几个实用的排查和解决方向：

1. 修正日志文件路径与权限问题 #

Azure WebApp的${basedir}指向的目录可能存在写入权限限制，或者路径在部署环境下和本地开发不一致。建议直接使用Azure WebApp提供的可写入目录路径：

• 修改NLog目标配置中的fileName为：

  fileName="${env:HOME}/site/wwwroot/logs/logfile-${shortdate}.txt"
  

${env:HOME}是Azure WebApp的环境变量，指向D:\home，这个目录下的site/wwwroot是你的应用根目录，拥有写入权限。

你可以通过Kudu工具（访问https://<你的应用名>.scm.azurewebsites.net/）的Debug Console -> PowerShell，手动进入site/wwwroot/logs目录，尝试创建文件验证权限是否正常。

2. 确保NLog配置文件被正确部署 #

很多时候问题出在NLog.config没有被复制到部署后的应用目录：

• 在Visual Studio中右键NLog.config文件，选择属性；
• 将复制到输出目录设置为如果较新则复制或始终复制；
• 重新部署应用，这样NLog的配置文件就会被同步到Azure WebApp的服务器上。

3. 开启Azure WebApp的文件系统日志功能 #

Azure WebApp默认可能限制了文件系统日志的写入，需要手动开启：

• 登录Azure门户，找到你的WebApp；
• 进入监控 -> 应用服务日志；
• 开启文件系统日志，设置合适的日志级别（比如Verbose），保存设置。
  这个步骤会让WebApp允许应用写入日志文件到指定路径。

4. 可选：改用Azure Blob存储存储日志 #

如果文件系统日志还是不稳定，推荐直接配置NLog将日志写入Azure Blob存储，这也是Azure官方推荐的日志存储方式：

• 首先安装NLog的Azure Blob扩展包：Install-Package NLog.Extensions.AzureBlobStorage
• 在NLog.config中添加Blob目标：

  <target name="azureBlob" xsi:type="AzureBlobStorage"
          connectionString="你的Azure存储连接字符串"
          container="logs"
          blobName="log-${shortdate}.txt"
          layout="${longdate} ${logger} ${message}${exception:format=ToString}" />
  

• 然后将这个目标添加到rules中即可。

5. 排查详细错误日志 #

如果以上步骤都没解决问题，可以通过Kudu工具查看应用的错误日志：

• 进入Kudu的Debug Console -> PowerShell，查看D:\home\LogFiles\Application目录下的日志文件，里面会记录应用启动时的错误，比如NLog初始化失败的原因。

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