开发1.12.2版本Minecraft模组时Java无法找到JSON文件如何解决

Minecraft 1.12.2 模组JSON文件加载失败排查方案 #

• 校验JSON严格语法：1.12.2 版本的JSON解析器采用完全严格模式，不允许末尾多余逗号、单引号包裹字符串、未闭合的括号/引号等语法问题，可使用jsonlint工具做本地校验，不要完全依赖代码编辑器的高亮提示，多数编辑器的JSON语法校验容错度较高，不会标记严格模式下的非法写法。
• 确认文件编码格式：JSON文件必须使用UTF-8 无BOM编码，带BOM的UTF-8编码会被Java类加载器识别为非法文件头，直接触发加载失败，可通过Notepad++等文本工具查看并转换编码。
• 核对资源目录结构：JSON文件必须放在对应规则的资源路径下，例如方块状态JSON要放在src/main/resources/assets/[你的模组ID]/blockstates目录，方块/物品模型JSON要放在models/block、models/item目录下；Java资源加载对大小写完全敏感，哪怕Windows系统下大小写不区分，打包运行后依然会因为大小写不匹配加载失败。
• 检查命名空间一致性：JSON文件中所有引用的模组命名空间必须和@Mod注解中声明的模组ID完全一致，大小写、拼写无任何偏差，命名空间不匹配会直接找不到对应资源。
• 排查构建配置规则：确认build.gradle的processResources配置没有过滤.json后缀的文件，默认的1.12.2 Forge MDK会自动包含resources目录下的所有资源，手动修改过构建规则可能会误排除JSON文件。
• 清理开发环境缓存：删除项目根目录下run文件夹的所有缓存内容后重新构建运行，旧的错误资源缓存没有被覆盖也会导致加载失败。
• 核查JSON内部引用：模型JSON的parent字段、textures字段引用的资源路径必须完全正确，不存在拼写、大小写偏差，引用不存在的资源会直接导致整个JSON加载失败。
• 提取运行日志报错：在运行日志中搜索Failed to load resource、Loading model error相关的堆栈信息，1.12.2 Forge会明确输出JSON加载失败的具体原因，比如路径不存在、语法错误、缺少必填字段等，可大幅提升排查效率。

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