Azure Web App异常301重定向至无效URL问题排查求助

核心问题本质 #

你的问题核心是AspNetCoreModuleV2启动失败（抛出500/503错误），导致应用代码完全没机会执行（断点未命中、Program.Main追踪日志为空），而Azure App Service底层的异常处理逻辑触发了非预期的301重定向，而非显示标准错误页面。

具体排查步骤 #

1. 深挖AspNetCoreModuleV2的详细日志 #

Kudu里的404只是重定向后的结果，真正的启动错误在模块专属日志里：

• 登录Azure门户，进入你的App Service → 监控 → 日志流，确保开启「Web服务器日志」和「详细错误日志」；
• 打开Kudu控制台，进入D:\home\LogFiles\AspNetCore目录，查看里面的日志文件，这里会记录应用启动失败的具体原因（比如依赖缺失、配置格式错误、端口占用等）。

2. 本地验证发布包的可用性 #

既然远程代码完全没触发，先确认本地发布的包本身没问题：

• 本地执行dotnet publish生成发布包，然后在发布目录直接运行dotnet 你的应用程序集.dll，看是否能正常启动，有没有报错；
• 核对Azure App Service的.NET版本（门户→设置→配置→常规设置）和本地开发环境的版本是否一致，版本不匹配会直接导致模块启动失败。

3. 检查App Service的异常配置项 #

就算没自定义域名，某些默认配置也可能被意外篡改：

• 进入门户→设置→配置→应用设置，检查是否有ASPNETCORE_FORWARDEDHEADERS_ENABLED、WEBSITE_REDIRECT_HTTP_TO_HTTPS这类可能影响跳转的配置，暂时禁用后重新测试；
• 查看WEBSITE_RUN_FROM_PACKAGE是否设为1，如果是，改为0重新部署，避免包加载异常导致的启动失败。

4. 排查应用启动依赖问题 #

AspNetCoreModuleV2的500/503错误大多和启动依赖有关：

• 检查发布包是否包含所有必要文件（第三方DLL、appsettings.json等），避免发布时漏打包；
• 如果应用依赖Azure服务（比如存储、SQL），核对连接字符串是否正确，同时确认App Service的系统身份是否有对应服务的访问权限。

5. 关于非预期301跳转的说明 #

当AspNetCoreModuleV2无法正常托管应用时，Azure App Service的反向代理层会触发异常跳转逻辑，这种情况是模块启动失败的连锁反应，只要解决了模块的启动问题，301跳转的现象自然会消失。

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