如何在Azure App Services网站的.NET应用中写入调试日志到文件？

1. 路径与权限问题 #

• Azure App Service的文件系统和本地完全不同，c:\temp这类系统盘路径要么不存在，要么应用运行账户没有写入权限。优先使用应用专属的可写路径，比如D:\home\tmp或D:\home\site\wwwroot，可以通过Azure门户的**高级工具（Kudu）**进入调试控制台，手动创建目录并测试写入。
• 避免硬编码系统盘路径，所有文件操作都应指向D:\home下的目录，这是App Service分配给应用的专属存储区域。

2. 日志配置检查 #

• 如果使用.NET自带日志组件或第三方框架（如Serilog、NLog），检查配置文件中是否仍保留本地的c:\temp\debug.log路径，替换为Azure支持的路径，比如D:\home\tmp\debug.log。
• 以ASP.NET Core为例，修改appsettings.json中的文件日志配置：

{
  "Logging": {
    "LogLevel": {
      "Default": "Debug",
      "Microsoft.AspNetCore": "Warning"
    },
    "File": {
      "Path": "D:\\home\\tmp\\debug.log",
      "Append": true
    }
  }
}

3. 运行时错误排查 #

• 在Azure门户的应用服务→日志流中实时监控应用输出，写入文件时的权限异常、路径不存在错误都会在这里显示。
• 通过Kudu的Debug Console进入D:\home\tmp目录，用dir命令查看日志文件是否生成，或用type debug.log查看内容是否正常写入。

云环境下不依赖本地文件的日志方案更可靠：

• App Service内置日志：在门户开启「应用日志（文件系统）」，日志会自动存储到D:\home\LogFiles，支持实时日志流查看和Kudu下载。
• Azure Monitor日志：将日志发送到Log Analytics工作区，支持多维度查询、告警和长期存储，适合生产环境。通过Microsoft.Extensions.Logging.AzureAppServices包集成，代码中直接注入ILogger即可使用。
• 第三方框架云集成：Serilog、NLog等框架可直接配置写入Azure Blob Storage或Azure Monitor，比本地文件更适配云场景。

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