Blazor WASM PWA读取appsettings.json配置返回null如何解决？

• 文件存放位置错误：Blazor WASM 的 appsettings.json 必须放置在项目的 wwwroot 目录下，而非项目根目录。Blazor WASM 运行在客户端侧，所有静态资源都需要从 wwwroot 目录下发，放在项目根目录的配置文件无法被客户端加载。
• 文件复制属性配置错误：右键点击 appsettings.json 文件，查看属性，确保「复制到输出目录」选项设置为 如果较新则复制 或 始终复制，否则编译后配置文件不会被输出到部署目录，客户端请求时会返回404。
• JSON 格式非法：检查 appsettings.json 的语法是否正确，是否存在缺少引号、逗号、括号不匹配等问题，格式错误的JSON会被配置系统直接忽略，导致所有key读取失败。
• PWA 缓存问题：PWA 的 Service Worker 可能缓存了旧的配置文件，甚至是配置文件不存在时的404响应。可以清空浏览器缓存、注销当前 Service Worker 后重新测试。
• 配置 Key 拼写/层级错误：检查代码中使用的Key和JSON文件中的Key拼写是否完全一致，若配置项是嵌套结构，需要用冒号分隔层级，例如 builder.Configuration["ParentNode:ChildKey"]。
• 自定义配置源覆盖默认规则：如果手动修改了 builder.Configuration 的配置源加载逻辑，可能默认的 appsettings.json 源被移除、或者加载顺序靠后被其他源覆盖，导致对应Key无法被读取。
• 服务器静态资源规则限制：如果是部署到线上环境出现该问题，检查服务器是否允许 .json 后缀的静态文件请求，是否存在路径重写规则拦截了 appsettings.json 的请求。

内容的提问来源于stack exchange，提问作者Kevin O'Donovan