.NET 7 Web API部署Azure App Service后出现500内部服务器错误
问题现象
将.NET 7 Web API部署到Azure App Service后，访问API端点时返回HTTP Error 500.0 - Internal Server Error，但Swagger页面可正常访问。
错误详情
HTTP Error 500.0 - Internal Server Error
无法显示页面，因为发生了内部服务器错误。
官方列出的可能原因
- IIS接收请求后处理过程中发生内部错误，根因与处理请求的模块、工作进程状态相关。
- IIS无法访问web.config文件，可能是NTFS权限配置错误。
- IIS无法解析网站/应用的配置内容。
- 已认证用户无目标DLL的访问权限。
- 请求映射到托管处理程序，但未安装.NET Extensibility功能。
官方建议的初步排查方向
- 确保web.config的NTFS权限允许Web服务器计算机账户访问。
- 查看事件日志获取更多错误细节。
- 验证目标DLL的权限配置。
- 若请求映射到托管处理程序，安装.NET Extensibility功能。
- 创建跟踪规则捕获该HTTP状态码的失败请求。
详细错误元数据
- 模块：AspNetCoreModuleV2
- 通知类型：ExecuteRequestHandler
- 处理程序：aspNetCore
- 错误代码：0x00000000
已完成的配置
- Azure App Service常规设置中已指定.NET 7运行时
- 解决方案包含的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="\.\TestV2.WebApi.dll" stdoutLogEnabled="false" stdoutLogFile="\\?\%home%\LogFiles\stdout" hostingModel="inprocess" /> </system.webServer> </location> </configuration>
- 通过Visual Studio发布配置文件完成部署
原因分析与解决方案
1. web.config中程序集路径错误
当前web.config的arguments字段使用了错误的路径格式\.\TestV2.WebApi.dll，开头的多余反斜杠会导致.NET运行时无法定位入口程序集，触发500错误。
修复方法：修改aspNetCore节点的路径配置：
<aspNetCore processPath="dotnet" arguments=".\TestV2.WebApi.dll" stdoutLogEnabled="false" stdoutLogFile="\\?\%home%\LogFiles\stdout" hostingModel="inprocess" />
也可直接简化为arguments="TestV2.WebApi.dll"。
2. 启用标准输出日志获取具体异常
当前stdout日志处于关闭状态（stdoutLogEnabled="false"），无法捕获.NET应用内部的业务异常或依赖错误。Swagger正常访问说明应用启动成功，但API端点的错误可能来自数据库连接、配置缺失或权限问题，需要具体日志定位。
修复方法：
- 修改web.config将
stdoutLogEnabled设为true，重新部署 - 登录Azure门户进入App Service的日志流页面，或通过Kudu工具查看
LogFiles/stdout目录下的日志，获取异常堆栈信息。
3. InProcess托管模型兼容性问题
使用hostingModel="inprocess"时，Azure App Service的IIS环境可能存在权限限制或运行时冲突，导致API端点请求失败。
修复方法：切换为OutOfProcess托管模型：
<aspNetCore processPath="dotnet" arguments=".\TestV2.WebApi.dll" stdoutLogEnabled="true" stdoutLogFile="\\?\%home%\LogFiles\stdout" hostingModel="outofprocess" />
同时确认Azure App Service的.NET版本配置与项目目标版本完全匹配（需指定具体的.NET 7.x子版本）。
4. 部署文件缺失或损坏
Visual Studio发布过程中可能遗漏依赖包、配置文件（如appsettings.json）等必要文件，导致API运行时出错。
修复方法：
- 在Visual Studio发布配置的文件发布选项中，勾选“删除目标中多余的文件”，并确认所有必要文件均包含在发布内容中
- 通过Kudu工具进入
site/wwwroot目录，检查TestV2.WebApi.dll、appsettings.json及依赖DLL是否完整。
5. API端点权限/资源访问问题
Swagger无需访问后端资源即可加载，但API端点可能涉及Azure存储、数据库等资源，若连接字符串配置错误或App Service无对应资源访问权限，会触发500错误。
修复方法：
- 检查
appsettings.json或Azure App Service配置中的连接字符串是否正确 - 确认App Service托管标识已在目标资源侧配置相应访问角色（如数据库的DB Reader/Writer角色）
内容的提问来源于stack exchange，提问作者Rakesh Kumar
