Azure App Service中runtimeconfig.json无效问题求助（ASP.NET Core 3.0）

我之前帮朋友排查过一模一样的问题，给你几个一步步的排查方向，应该能解决：

第一步：先在本地验证问题根源 #

• 先检查本地发布目录里的runtimeconfig.json文件，直接用VS打开它，仔细看有没有JSON语法错误——比如末尾多了逗号、括号没配对、引号不闭合这种小问题。ASP.NET Core对这个文件的格式要求特别严格，哪怕一个标点错了都会触发这个报错。
• 试着在本地运行发布后的项目：打开命令行，切换到发布输出目录（一般是bin\Release\netcoreapp3.0\publish），执行dotnet 你的项目名称.dll。如果本地也弹出同样的错误，那问题肯定在本地的配置或发布流程上，不用先折腾Azure。

第二步：检查Azure App Service的运行时配置 #

• 登录Azure门户，找到你的App Service，进入「配置」→「常规设置」，确认“.NET版本”选的是.NET Core 3.0（千万别选成.NET Framework，这俩是完全不同的运行时）。选错版本的话，Azure根本找不到对应的运行环境，自然会报错。改完记得重启App Service。
• 核对发布模式：VS2019发布时，有「框架依赖」和「自包含」两种模式。如果是框架依赖，必须确保Azure上已经安装了.NET Core 3.0运行时；如果是自包含，要确认发布时选择的目标平台和Azure服务器匹配（比如Azure是Windows主机，别选Linux目标平台）。

第三步：确认Azure上的文件完整性和正确性 #

• 用Azure的Kudu工具检查文件：进入App Service的「高级工具」→「Go」，打开Kudu后，点击「Debug console」→「CMD」，导航到site\wwwroot目录，看看runtimeconfig.json是否存在，内容和本地发布的文件是否完全一致。如果不一致，手动上传本地正确的文件覆盖试试。
• 顺便检查一下目录里有没有runtimeconfig.dev.json，这个是本地开发调试用的，发布时应该被排除，如果它出现在Azure的生产目录里，删掉它——有时候这个文件会干扰生产环境的配置读取。

第四步：排查特殊场景 #

• 如果你的项目里有自定义的runtimeconfig.template.json，检查这个模板文件的格式是否正确。发布时ASP.NET Core会基于这个模板生成最终的runtimeconfig.json，模板错了生成的文件自然也无效。
• 检查NuGet包依赖：有没有引用的包和.NET Core 3.0不兼容？比如某些旧版本的包可能会在runtimeconfig里写入无效的配置项。试试把所有NuGet包更新到兼容3.0的版本，或者移除不必要的依赖包再重新发布。

按这个顺序排查，应该能找到问题所在。

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