部署.NET 7 API至Azure Web Service遇HTTP Error 500.30启动失败

1. 检查启动命令配置 #

• 登录Azure门户，进入你的Web Service，在配置 > 常规设置里，确认启动命令是否正确。对于.NET 7 API，通常不需要手动指定，但如果是自包含部署，可能需要设置为dotnet 你的项目名.dll或者直接指定可执行文件路径。
• 如果是使用发布配置文件部署，检查.pubxml里的<LaunchCommand>是否正确。

2. 查看应用日志 #

• 在Azure门户的Web Service中，进入监控 > 日志流，实时查看应用启动时的错误日志，这里会显示具体的异常信息（比如依赖缺失、配置错误、数据库连接失败等）。
• 也可以在高级工具 > Kudu中，进入LogFiles/Application目录，查看stdout和stderr日志文件，获取更详细的启动失败原因。

3. 验证*.NET运行时版本* #

• 确认Azure Web Service的运行时栈是否设置为*.NET 7*：在配置 > 常规设置里，检查运行时堆栈是否选择了.NET 7 (STS)。如果是自包含部署，确保发布时选择了对应操作系统的目标运行时，且Web Service的操作系统（Windows/Linux）与发布包匹配。

4. 检查应用配置和依赖 #

• 本地测试：在本地模拟Azure环境（比如使用dotnet run --environment Production），确认应用能正常启动，排除代码或配置本身的问题。
• 配置文件：检查appsettings.json或环境变量中的敏感配置（如数据库连接字符串、API密钥）是否在Azure中正确设置（可通过配置 > 应用程序设置查看），避免因配置缺失导致启动失败。
• 依赖项：确认项目的NuGet包是否都兼容.NET 7，有没有引用过时或不兼容的包，尤其是第三方组件。

5. 检查部署包完整性 #

• 通过Kudu的调试控制台，进入site/wwwroot目录，确认部署包的文件结构是否完整，有没有缺失必要的DLL文件或静态资源。
• 重新发布：尝试清理本地发布目录，重新生成并部署，避免因发布过程中文件损坏导致的问题。

6. 排查端口绑定问题 #

• ASP.NET Core在Azure Web Service中会自动使用指定的端口，不需要手动设置UseUrls。检查代码中是否硬编码了端口号，这会导致与Azure的端口配置冲突。

内容的提问来源于stack exchange，提问作者Yawar manzoor sheikh