FHIR Java Proto编译失败：符号缺失问题求助

问题根源 #

你遇到的编译错误，本质是生成的Java文件依赖了FHIR STU3规范里的基础类型/资源类，但这些依赖类并没有被正确生成或者没有加入到编译路径中。比如ReferenceOrBuilder对应FHIR的Reference资源的Builder类，PositiveInt是FHIR定义的基础数据类型，它们都需要从对应的proto文件生成，而如果你的generate-proto.sh只处理了部分资源proto，就会出现这类缺失。

分步解决方案 #

1. 检查并补全proto文件的生成范围

Google FHIR仓库的proto/stu3目录下不仅有业务资源的proto，还有基础类型、通用结构的proto文件（比如reference.proto、positive_int.proto）。你需要确保generate-proto.sh脚本处理了所有相关的proto文件：

• 打开generate-proto.sh，查看它是否只指定了单个或部分proto，还是遍历了所有.proto文件。
• 如果脚本有遗漏，可以手动用protoc命令补全生成：

  # 切换到仓库根目录
  cd ~/fhir-master
  # 生成所有STU3相关的proto文件，包括基础类型
  protoc --java_out=proto/stu3/target \
    --proto_path=proto/stu3 \
    --proto_path=proto/common \
    proto/stu3/**/*.proto \
    proto/common/**/*.proto
  

  这里的proto/common目录包含了FHIR通用的基础类型定义，必须加入到proto路径中。

2. 确保编译路径包含所有生成的类

生成的Java文件需要放在同一个项目的源码目录下，或者在编译时把~/fhir-master/proto/stu3/target加入到classpath中。比如用Maven的话，可以在pom.xml里添加：

<build>
  <resources>
    <resource>
      <directory>~/fhir-master/proto/stu3/target</directory>
    </resource>
  </resources>
</build>

3. 更可靠的替代方案：直接引入官方预构建库

与其自己手动生成，不如直接引入Google官方构建好的FHIR STU3 Java库，这样可以避免依赖缺失的问题。比如Maven依赖：

<dependency>
  <groupId>com.google.fhir</groupId>
  <artifactId>stu3</artifactId>
  <version>0.3.0</version> <!-- 替换为最新稳定版本 -->
</dependency>

关于你提到的Hazel生成类 #

你之前生成的com/google/...路径的类，确实是通过FHIR Hazel工具生成的。Hazel是Google官方用于从FHIR规范自动生成proto和Java类的工具，它会完整处理FHIR的所有资源、基础类型、扩展结构，生成的类之间依赖关系是完整的，不会出现编译缺失的问题。

Hazel的基本使用步骤（针对STU3）：

1. 确保你已经克隆了完整的google-fhir仓库（Hazel是其中的一部分）
2. 运行Hazel的生成命令：

   cd ~/fhir-master/hazel
   bazel run //java/com/google/fhir/hazel:GenerateStu3
   

   这个命令会自动生成所有STU3对应的proto和Java类，输出到指定目录，生成的文件依赖完整，可以直接编译使用。

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