如何部署.NET Core 6 Angular VS模板项目到Azure并排查500错误

第一步：先拿到具体错误信息，不要盲目改配置 #

500是服务端通用错误，没有异常栈猜原因效率极低，先做以下操作拿精准报错：

• 开启App Service日志：进入Azure门户对应App Service的「应用服务日志」面板，打开应用程序日志记录(文件系统)，级别选Verbose，同时开启「详细错误消息」「失败请求跟踪」，保存配置后等待1分钟，复现500错误，直接打开「日志流」面板就能看到实时抛出的完整异常栈，90%的问题看异常栈就能直接定位。
• 本地Release模式验证：把VS的生成配置从Debug切到Release，不要用IIS Express启动，直接选项目本身自托管运行，确认Release配置下所有功能（尤其是Identity登录注册、数据库操作）正常，排除本地Debug环境和Release环境的配置差异。
• 校验发布配置：右键项目选择「发布」，打开「显示所有设置」面板，确认部署模式、目标运行时和你创建的App Service运行环境匹配（比如选框架依赖+win-x64就对应Windows 64位的.NET6 App Service），一定要勾选发布前删除目标位置所有现有文件，避免旧版本残留文件导致的程序集加载冲突。

第二步：高频遗漏配置排查（针对Identity+Azure SQL+Angular场景） #

按出现概率从高到低检查：

• Azure SQL防火墙/连接字符串配置错误
  本地能连Azure SQL不代表App Service能连：
  • 进入Azure SQL的「防火墙和虚拟网络」设置，打开允许Azure服务和资源访问此服务器开关，不然App Service的出站IP会被SQL防火墙拦截，直接连库失败。
  • 进入App Service的「配置」-「连接字符串」，新增一条和代码中ConnectionStrings节点同名的配置（默认Identity模板的连接名是DefaultConnection），值填Azure SQL的连接串，连接串要带上Encrypt=True;TrustServerCertificate=False参数，配置类型选SQLAzure，不要选自定义类型。不要只把连接串存在appsettings.json里，发布后配置优先级App Service配置 > 本地配置文件。
• Identity数据库迁移未执行
  本地运行时VS会自动触发EF Core迁移初始化数据库，但发布到Azure后不会自动执行：要么在VS发布设置里勾选执行Code First迁移（仅框架依赖部署模式支持），要么进入App Service的Kudu控制台（地址格式为https://<你的应用名>.scm.azurewebsites.net），进入site/wwwroot目录执行dotnet ef database update，同步Identity相关的表结构到Azure SQL，连库成功但表不存在也会直接抛500。
• Angular前端静态文件未正常生成
  .NET 6 Angular模板发布时会自动执行npm install、ng build生成前端静态资源，如果发布时未触发前端构建，会找不到dist目录下的文件抛错：
  进入Kudu控制台查看site/wwwroot/ClientApp/dist目录下是否存在编译后的Angular文件，如果为空，就在VS发布设置里勾选在发布时生成Angular应用，或者本地先手动执行ng build --prod，把生成的dist目录随项目一起发布。
• Identity数据保护密钥未持久化
  .NET Core Identity依赖数据保护模块做密码、身份令牌的加解密，本地运行时密钥存在本机用户目录，发布到Azure后如果没配置持久化密钥存储，应用启动时会因为找不到密钥抛加密相关异常。临时排查可先在App Service配置里加应用设置ASPNETCORE_ENVIRONMENT = Development测试（生产环境严禁长期开启Development环境），如果开了之后应用能正常访问，就说明是数据保护配置问题，生产环境可以把密钥存在Azure Key Vault或者Blob存储做持久化。
• 端口监听配置错误
  Azure App Service会通过PORT环境变量告知应用需要监听的端口，如果手动修改过Program.cs的启动配置，不要写死5000/5001端口，要保留默认的动态端口读取逻辑，否则应用会直接启动失败。

快速定位小技巧 #

• 先不要访问业务首页，直接访问一个不存在的路由比如/test-route-123，如果连404页面都无法返回，说明.NET后端根本没启动成功，问题出在启动配置、依赖缺失、端口监听这块；如果能正常返回404，只有访问Identity相关功能出500，基本就是数据库连接、迁移、数据保护密钥的问题。
• 打开App Service的「诊断并解决问题」面板，搜索「500错误」「应用启动失败」，Azure自带的诊断工具会自动扫描最近的应用日志，直接给出具体的异常原因，比手动翻日志效率更高。

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