Azure Linux 环境下 Web App 日志功能异常无法获取启动报错信息

修复日志采集配置 #

• 校验运行栈基础配置：进入对应WebApp的配置 > 常规设置，确认运行时栈选择.NET，版本和你项目使用的.NET版本完全匹配，启动命令填写dotnet <你的项目入口dll名称>.dll，替换为实际的入口项目dll文件名，保存配置。
• 强制开启标准输出日志：在Blazor服务端项目根目录新增/修改web.config文件，发布时同步到服务端，配置示例如下：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <handlers>
        <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
      </handlers>
      <aspNetCore processPath="dotnet" arguments=".\<你的项目入口dll名称>.dll" stdoutLogEnabled="true" stdoutLogFile="/home/LogFiles/stdout" hostingModel="inprocess" />
    </system.webServer>
  </location>
</configuration>

• 调整应用服务日志规则：进入监控 > 应用服务日志，开启应用程序日志（文件系统），级别选择信息或调试，同时开启Web服务器日志（文件系统），保留期限设置为7天，保存后重启WebApp。
• 正确查看日志：不要使用FTP查找日志，直接通过Azure门户内置Kudu工具访问：进入开发工具 > 高级工具 > 转到，在Kudu界面选择Debug console > Bash，执行cd /home/LogFiles/ && ls -la即可看到所有日志文件，点击文件名可直接查看内容。

常见启动崩溃原因排查 #

• 运行时标识不匹配：发布项目时指定Linux x64运行时标识，避免依赖缺失，发布命令参考：dotnet publish -c Release -r linux-x64 --self-contained false
• 大小写问题：Linux系统区分大小写，检查代码中所有静态资源路径、配置文件路径的大小写和实际文件完全一致
• 配置项缺失：所有appsettings.json中的必填配置（如数据库连接串、服务密钥），需在WebApp的配置 > 应用程序设置中重新配置，云端应用设置优先级高于本地配置文件
• 端口硬编码问题：不要在代码中硬绑定服务端口，Azure Linux App Service会自动通过PORT环境变量分配端口，使用ASP.NET Core默认端口绑定逻辑即可

临时调试方案 #

如果上述操作仍无法获取启动日志，可以将WebApp的启动命令临时修改为dotnet <你的项目入口dll名称>.dll > /home/LogFiles/startup.log 2>&1，保存重启后到Kudu的/home/LogFiles/目录查看startup.log，即可获取完整的启动阶段输出和错误信息。

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