@XmlJavaTypeAdapter无法解析致运行时错误，Maven编译异常排查

首先明确核心问题：编译阶段编译器无法找到com.example.project.DateAdapter类，导致它错误地将导入语句处理为import DateAdapter.java（这是编译器找不到类时的异常表现，而非正常逻辑）。你的怀疑方向有一定合理性，但根源通常是源码目录配置、编译顺序或类路径匹配问题，以下是具体排查步骤和解决办法：

排查步骤与解决办法 #

1. 先验证适配器类的基础正确性 #

• 检查src/main/java/com/example/project/下是否存在DateAdapter.java，确保：
  • 包名完全匹配（大小写敏感，比如com.example.Project和com.example.project是不同包）
  • 类名拼写正确，且是public修饰的类
  • 类继承了XmlAdapter并正确实现了marshal/unmarshal方法

2. 检查build-helper-maven-plugin的配置 #

确保插件在正确的阶段执行，且生成的源码目录被正确添加到类路径：

<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>build-helper-maven-plugin</artifactId>
  <executions>
    <execution>
      <id>add-jaxb-sources</id>
      <!-- 必须绑定在generate-sources阶段，确保在编译前生效 -->
      <phase>generate-sources</phase>
      <goals>
        <goal>add-source</goal>
      </goals>
      <configuration>
        <sources>
          <!-- 指向jaxb生成的源码目录 -->
          <source>${project.build.directory}/generated-sources/jaxb</source>
        </sources>
      </configuration>
    </execution>
  </executions>
</plugin>

同时要保证jaxb2-maven-plugin也绑定在generate-sources阶段，确保生成源码后再添加到类路径：

<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>jaxb2-maven-plugin</artifactId>
  <executions>
    <execution>
      <id>xjc-generate</id>
      <phase>generate-sources</phase>
      <goals>
        <goal>xjc</goal>
      </goals>
      <configuration>
        <schemaDirectory>src/main/resources/xsd</schemaDirectory>
        <bindingDirectory>src/main/resources/xjb</bindingDirectory>
      </configuration>
    </execution>
  </executions>
</plugin>

3. 检查maven-compiler-plugin的配置 #

确保编译插件没有排除src/main/java目录（默认是包含的，但如果自定义了配置可能出错）：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.11.0</version>
  <configuration>
    <source>1.8</source> <!-- 替换为你的JDK版本 -->
    <target>1.8</target>
    <!-- 不要添加排除src/main/java的配置 -->
  </configuration>
</plugin>

4. 强制清理并重新编译，查看日志定位问题 #

执行命令：

mvn clean compile -X

查看日志中编译阶段的输出，重点关注：

• 是否有找不到符号: 类 DateAdapter的警告/错误
• 编译器是否加载了src/main/java目录下的源码
• 生成的jaxb类的import语句在编译前是否正确

5. 排查VSCode缓存问题 #

如果使用VSCode开发，可能存在IDE缓存导致的异常：

• 关闭VSCode，删除项目根目录下的.vscode文件夹
• 重新打开项目，执行mvn clean install -U强制更新依赖并重新构建

核心结论 #

你的怀疑有一定依据，但本质是编译阶段编译器无法定位到适配器类，而非单纯的无法访问src目录。通过上述步骤排查，大概率能解决导入语句错误的问题。

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