将ASP.NET应用迁移至Azure App Service与数据库时遇错误求助

问题概述 #

1. 本地ASP.NET应用迁移后，前端部署至Azure App Service、后端使用Azure数据库，访问时触发500.19 Internal Server Error（提示页面配置数据无效）。
2. 迁移前的评估环节报错，无法获取数据库连接字符串，导致评估失败。

一、迁移评估错误修复 #

• 校验数据库连接字符串：
  确认本地web.config中的Azure数据库连接字符串格式正确，示例格式：

  Server=tcp:{server-name}.database.windows.net,1433;Initial Catalog={db-name};Persist Security Info=False;User ID={username};Password={password};MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;
  

  同时需在Azure数据库防火墙设置中，添加本地机器IP和Azure App Service的出站IP至白名单，确保评估工具能正常连接数据库。
• 确认评估工具权限：
  运行迁移评估的账号需具备读取本地web.config以及访问Azure数据库的权限，避免因权限不足导致连接失败。

二、500.19访问错误修复 #

• 对齐.NET运行时版本：
  登录Azure Portal，进入目标App Service，在「设置 > 配置 > 常规设置」中，将.NET版本调整为与本地应用一致的版本（如本地用.NET Framework 4.8，Azure需同步选择该版本）。
• 修复web.config兼容性问题：
  Azure App Service默认环境不支持部分本地IIS自定义配置（如特定modules或handlers节点），可移除不必要的自定义配置；或在「配置 > 应用设置」中添加WEBSITE_LOAD_USER_PROFILE并设为1，开启用户配置文件加载。
• 验证部署完整性与权限：
  通过Azure Portal的「开发工具 > 高级工具 > Kudu」查看站点文件，确认web.config等关键文件未丢失；同时检查应用服务计划权限，确保应用具备读取配置文件的权限。
• 查看详细错误日志：
  在App Service的「诊断设置 > 日志」中开启日志收集，或临时修改web.config显示详细错误：

  <system.web>
    <customErrors mode="Off"/>
  </system.web>
  <system.webServer>
    <httpErrors errorMode="Detailed"/>
  </system.webServer>
  

  （注：生产环境需关闭详细错误，防止敏感信息泄露）

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