Maven编译报错无法访问RestController，请求排查原因

你遇到的是Java编译阶段的错误，不是Spring容器启动时的组件扫描问题，所以先把注意力放在代码本身和编译环境上，以下是几个常见的排查方向：

1. 检查RestController类的基本情况 #

• 确认com.yax.aragon.external.controller.RestController这个类确实存在：去对应路径下找这个文件，是不是误删了？或者文件名拼写错误？比如把RestController.java写成了RestControll.java？
• 检查这个类的访问修饰符：如果它是private或者默认权限（没有写public），那同包的AccountController是无法访问它的（如果是继承或者直接引用的话）。确保RestController类的修饰符是public。
• 是不是你把Spring的@RestController注解和自己定义的RestController类搞混了？比如本来应该导入org.springframework.web.bind.annotation.RestController注解，结果不小心写成了引用自己的com.yax.aragon.external.controller.RestController类？这种情况下要检查AccountController里的导入语句。

2. 清理Maven编译缓存 #

有时候Maven的编译缓存会残留旧的编译信息，导致奇怪的错误。执行以下命令彻底清理后重新编译：

mvn clean install

这个命令会先删除target目录下的所有编译产物，然后重新执行编译和安装。

3. 检查IDE与文件系统的一致性 #

如果你是用IDE（比如IntelliJ IDEA、Eclipse）开发，可能存在IDE索引和实际文件不同步的情况：

• 刷新你的项目：比如在IDEA里右键项目选择「Reload All Maven Projects」，Eclipse里选择「Refresh」。
• 确认IDE中显示的RestController类在实际文件系统中确实存在：有时候IDE的缓存会显示已删除的文件，实际磁盘上已经没了。

4. 检查Maven编译插件的配置 #

虽然你用的是maven-compiler-plugin:3.8.0，这个版本比较稳定，但还是可以检查一下插件的配置是否正确，比如指定的Java版本和你的项目代码是否匹配：
在pom.xml里确认编译插件的配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.0</version>
            <configuration>
                <source>1.8</source> <!-- 改成你项目用的Java版本，比如11、17 -->
                <target>1.8</target>
            </configuration>
        </plugin>
    </plugins>
</build>

如果Java版本不匹配，也可能导致一些编译层面的访问问题。

5. 检查是否存在依赖冲突或缺失 #

虽然这个错误看起来不像是依赖问题，但如果RestController类依赖了其他缺失的类，也可能导致编译时无法访问它。可以检查RestController类的代码，看看它有没有引用其他未编译或者缺失的类。

内容的提问来源于stack exchange，提问作者Caner Aydın