Spring Boot跨项目访问类异常：无法导入UserPrincipal类

你已经尝试通过Maven依赖引入UserService，但还是没法导入UserPrincipal类，我来帮你一步步排查可能的问题：

1. 确保UserService已正确安装到Maven仓库 #

首先要确认UserService项目已经被编译、打包并安装到本地Maven仓库——如果依赖的jar包根本不在仓库里，TransactionService自然找不到对应的类。

• 进入UserService项目的根目录，执行以下Maven命令：

  mvn clean install
  

  这个命令会把项目编译成jar包，并同步到本地Maven仓库（默认路径是~/.m2/repository）。

2. 检查UserPrincipal类的访问权限与打包配置 #

要让其他项目能导入这个类，必须满足两个条件：

• 类本身是public修饰的，不能是包私有（即没有访问修饰符）：

  public class UserPrincipal {
      // 类的具体实现
  }
  

• 检查UserService的pom.xml，有没有给依赖设置奇怪的<scope>（比如provided），如果有，改成默认的compile（可以直接删除<scope>标签，Maven默认就是compile范围）。

3. 核对TransactionService的依赖配置准确性 #

再仔细核对TransactionService里的依赖信息：

• 确保groupId、artifactId、version和UserService的pom.xml完全一致，Maven对这些字段是大小写敏感的，哪怕一个字母大小写错了都不行。
• 如果UserService是多模块项目，确认你依赖的是包含UserPrincipal类的那个模块。

4. 刷新IDE缓存与Maven依赖 #

有时候IDE的缓存会导致依赖不更新，试试这两步：

• 在IDE（比如IntelliJ IDEA）中，点击Maven面板的Reload All Maven Projects按钮，强制刷新依赖。
• 执行TransactionService的清理命令，清除旧的编译缓存：

  mvn clean
  

  之后重新编译项目。

5. 手动验证本地仓库的jar包 #

如果以上步骤都没解决问题，直接去本地Maven仓库检查UserService的jar包：

• 找到路径：~/.m2/repository/com/assignment/user-service/0.0.1-SNAPSHOT/user-service-0.0.1-SNAPSHOT.jar
• 解压这个jar包，查看里面是否包含UserPrincipal类。如果没有，说明UserService打包时漏掉了这个类，需要检查项目的打包配置（比如是否有<excludes>规则排除了该类）。

按照这些步骤排查下来，应该能解决无法导入UserPrincipal类的问题。

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