部署于Azure App Service的Blazor WASM切换生产环境出现500错误问题

1. 优先抓取具体错误信息 #

出现500错误的核心原因是应用启动或运行时抛出了未捕获异常，首先要拿到具体的异常栈才能定位问题：

• 临时开启生产环境详细错误：在Azure Web应用的「配置」->「环境变量」中，新增ASPNETCORE_DETAILEDERRORS = true、ASPNETCORE_ENABLE_DIAGNOSTICS_PAGES = true，保存后重启应用，再次访问就能看到具体的错误详情
• 查看Azure日志流：进入Web应用的「监视」->「日志流」，启动日志流后刷新访问页面，可以实时捕获应用的启动报错、运行时异常日志
• 临时切换环境：如果还是看不到错误，可以先把ASPNETCORE_ENVIRONMENT切回Development，复现问题拿到异常栈后再切回Production排查

注意：以上临时配置排查完成后务必删除，避免泄露敏感的代码、配置信息

2. 排查Blazor生产环境专属常见问题 #

这是大多数同类问题的诱因，优先检查：

• 配置文件校验：确认发布包中存在appsettings.Production.json，里面的数据库连接串、第三方服务密钥、CORS规则、身份验证配置（如JWT签发方、密钥）和开发环境的有效配置一致，没有缺失或错误值
• 静态资源检查：Blazor生产构建会对静态资源做压缩、哈希重命名，确认发布包的wwwroot目录下包含完整的_blazor文件夹、编译后的wasm资源、css/js绑定文件，没有出现部署时的资源遗漏
• 托管模式路由校验：如果是Blazor WebAssembly托管模式，确认后端API的路由配置没有和前端静态资源路由冲突，后端的接口鉴权规则和前端调用逻辑匹配，没有出现跨域、鉴权失败导致的服务启动异常
• 权限校验：生产环境下Azure Web应用的运行账户权限和本地开发环境不同，确认应用需要读写的本地目录、证书访问权限、存储服务访问权限都已经正确配置

3. 排查Azure平台配置问题 #

• 运行时版本匹配：确认Azure Web应用配置的.NET运行时版本和你本地构建、发布使用的SDK版本完全一致，版本不兼容会直接导致应用启动失败
• 发布校验：进入「部署中心」查看最近的发布记录，确认构建、部署流程全部成功，没有出现编译错误、文件上传失败导致的生产代码不完整
• 资源配额检查：确认Azure Web应用的CPU、内存、磁盘配额没有被占满，资源不足也会触发500错误

应急恢复方案 #

如果需要先恢复业务，可以先将ASPNETCORE_ENVIRONMENT切回Development，待问题定位修复完成后再切回Production。

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