Spring Boot编译打包后运行报Repository空指针，IDE运行正常求助

可能原因及解决方案 #

1. 检查maven-assembly-plugin配置 #

mvn compile assembly:single打包时，若配置不当会导致Spring核心类、配置文件或Repository类缺失，引发注入失败。确保插件配置包含以下关键项：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-assembly-plugin</artifactId>
    <version>3.3.0</version>
    <configuration>
        <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
        </descriptorRefs>
        <archive>
            <manifest>
                <!-- 替换为你的主类全限定名 -->
                <mainClass>com.example.YourMainClass</mainClass>
            </manifest>
        </archive>
        <appendAssemblyId>false</appendAssemblyId>
        <!-- 排除重复依赖，避免类冲突 -->
        <dependencySets>
            <dependencySet>
                <unpack>true</unpack>
                <scope>runtime</scope>
                <excludes>
                    <exclude>org.springframework.boot:spring-boot-starter-tomcat</exclude>
                </excludes>
            </dependencySet>
        </dependencySets>
    </configuration>
    <executions>
        <execution>
            <id>make-assembly</id>
            <phase>package</phase>
            <goals>
                <goal>single</goal>
            </goals>
        </execution>
    </executions>
</plugin>

2. 确保Spring上下文正确初始化 #

• 主类必须标注@SpringBootApplication（Spring Boot项目），确保启动时扫描Repository所在包：

  @SpringBootApplication(scanBasePackages = "com.example")
  public class YourMainClass {
      public static void main(String[] args) {
          // 必须通过Spring容器获取Bean，禁止手动new对象
          ApplicationContext context = SpringApplication.run(YourMainClass.class, args);
          YourService service = context.getBean(YourService.class);
          // 调用业务方法
      }
  }
  

• 若手动实例化依赖Repository的类（比如new YourService()），Spring无法注入Repository，必然出现空指针。

3. 检查Repository及注入类的注解 #

• Repository接口需标注@Repository，或继承Spring Data的JpaRepository/CrudRepository（Spring会自动识别并创建代理类）：

  @Repository
  public interface YourRepository extends JpaRepository<YourEntity, Long> {
  }
  

• 依赖Repository的类（如Service）必须被Spring管理，标注@Service/@Component，并使用构造方法注入（推荐）：

  @Service
  public class YourService {
      private final YourRepository repository;
  
      // 构造方法注入，无需@Autowired（Spring 4.3+自动支持）
      public YourService(YourRepository repository) {
          this.repository = repository;
      }
  }
  

4. 验证打包后的Jar内容 #

执行命令jar tf fileName.jar，检查以下内容是否存在：

• Repository接口的.class文件（如com/example/repository/YourRepository.class）
• Spring配置文件（如application.properties/application.yml）
• 主类的.class文件
• Spring核心依赖（如spring-context-*.jar、spring-data-jpa-*.jar）

5. 替换为Spring Boot官方打包插件（推荐） #

若assembly插件适配问题多，改用Spring Boot官方插件，自动处理依赖打包和上下文初始化：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <version>2.7.15</version> <!-- 替换为你的Spring Boot版本 -->
    <executions>
        <execution>
            <goals>
                <goal>repackage</goal>
            </goals>
        </execution>
    </executions>
</plugin>

打包命令改为mvn clean package，运行java -jar target/your-project.jar即可。

内容的提问来源于stack exchange，提问作者Zdeněk Nováček