Azure WebApp未读取appsettings.json文件及排查异常求助

你遇到的这个情况确实有点棘手——明明修改甚至删除了所有本地的appsettings文件，应用却还在揪着旧的clientId报错。别担心，这大概率是Azure App Service的配置优先级覆盖了本地文件，或者存在缓存、遗留配置的情况，咱们一步步来排查解决：

1. 先查Azure门户的应用设置（最可能的原因） #

Azure App Service自带的应用设置优先级远高于本地appsettings.json，哪怕你删了本地文件，门户里的配置依然会生效：

• 登录Azure门户找到你的WebApp，进入配置 > 应用设置选项卡
• 搜索clientId相关的配置项，如果能找到旧的那个值，那就是它在搞鬼！直接修改成正确值或者删除该配置，点击保存后应用会自动重启，应该就能解决问题

2. 检查部署槽位的配置（如果用了槽位） #

要是你用了部署槽位（Deployment Slots），每个槽位都有独立的应用设置：

• 进入对应的部署槽，同样查看配置 > 应用设置
• 确认槽位里没有遗留的旧clientId，必要时可以用“同步”功能把生产槽的配置同步到其他槽位

3. 清掉App Service的站点缓存 #

有时候应用会缓存配置值，哪怕你改了配置也不会立即生效：

• 进入App Service的高级工具 > Go（也就是Kudu控制台）
• 切换到Debug console > CMD，执行命令：

  del %HOME%\site\wwwroot\aspnetcore-*.xml
  

  这会清除ASP.NET Core应用的配置缓存，之后手动重启应用试试

4. 确认部署目录里的文件是否干净 #

虽然你本地改了文件，但可能部署的时候旧的appsettings.json还被打包传上去了：

• 用在线App Service Editor打开site/wwwroot目录，检查所有appsettings相关文件，确认有没有旧clientId残留
• 如果有，直接在编辑器里修改或删除这些文件，保存后重启应用

5. 排查环境变量的影响 #

ASP.NET Core会自动读取环境变量，而且环境变量的优先级也高于appsettings.json：

• 在Kudu控制台的CMD里执行set命令，看看有没有clientId相关的环境变量
• 如果存在，说明是环境变量覆盖了本地配置，得回到App Service门户的应用设置里修改或删除对应的变量

6. 确认配置加载顺序是否符合预期 #

最后再确认下ASP.NET Core的配置加载优先级，避免踩环境的坑：
环境变量 > Azure门户应用设置 > appsettings.{Environment}.json > appsettings.json
检查门户里的ASPNETCORE_ENVIRONMENT环境变量是否正确，比如是不是误设成了Production，导致加载了对应环境的配置文件（而你可能没改那个文件）

按照上面的步骤排查下来，应该能找到旧clientId的来源并解决问题。

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