我之前在处理FHIR R4 Java模型生成时也踩过类似的坑，结合实际经验给你梳理几个排查方向和解决方案：

1. 确认代码生成插件的配置是否准确 #

首先得明确你用的是哪款代码生成插件（比如最常用的jsonschema2pojo-maven-plugin），FHIR的Schema结构复杂，插件配置稍有偏差就会导致生成失败：

• 检查pom.xml中插件的sourceDirectory是否正确指向src/main/resources/schema，同时确认该目录下确实存放了完整的FHIR R4 Schema文件，不是单个零散文件
• 确认插件的outputDirectory设置为target/generated-sources/java——这是Maven默认的源码生成目录，插件必须输出到这里才能被后续构建阶段识别
• 务必确保插件绑定了正确的Maven生命周期阶段，比如绑定到generate-sources，这样执行mvn package时才会触发代码生成。示例配置片段：

<executions>
  <execution>
    <goals>
      <goal>generate</goal>
    </goals>
    <phase>generate-sources</phase>
  </execution>
</executions>

2. 检查FHIR JSON Schema的完整性 #

FHIR R4的JSON Schema是一个相互依赖的体系，包含核心定义、资源Schema等多个文件，如果只放入单个Schema文件，插件会因为无法解析内部$ref引用而静默失败：

• 确认你下载的是FHIR官方提供的完整R4 Schema压缩包，解压后把所有文件都放到src/main/resources/schema目录下
• 可以打开某个资源Schema文件（比如Patient.schema.json），检查里面的$ref引用是否能在你的目录中找到对应的文件，比如core.schema.json

3. 查看Maven构建的详细日志，捕捉隐藏错误 #

虽然构建显示BUILD SUCCESS，但代码生成插件可能在执行时出现了警告或非致命错误，只是没有中断整个构建。你可以执行以下命令查看完整Debug日志：

mvn package -X

搜索插件相关的输出（比如jsonschema2pojo），重点关注类似“无法解析Schema引用”“找不到指定Schema文件”这类信息，这些往往是生成失败的核心原因。

4. 验证插件版本与FHIR Schema的兼容性 #

不同版本的代码生成插件对JSON Schema关键字的支持程度不同，旧版本插件可能无法处理FHIR R4中复杂的oneOf/anyOf结构：

• 尝试将插件升级到最新稳定版本，比如jsonschema2pojo-maven-plugin可以升级到1.2.10版本
• 如果使用的是其他插件（比如openapi-generator-maven-plugin），要确认它对FHIR Schema的支持性，部分插件更适配OpenAPI规范，而非FHIR这种复杂的医疗领域Schema

5. 确认生成目录是否被IDE正确识别 #

有时候代码已经成功生成，但IDE（比如IntelliJ IDEA、Eclipse）没有自动将target/generated-sources/java标记为源码目录，导致你看不到生成的类：

• 手动打开文件管理器，查看target/generated-sources/java目录下是否有生成的Java类文件
• 如果确实存在，在IDE中手动将该目录标记为「Generated Sources Root」（不同IDE操作略有差异）

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