springboot项目Maven打包遇到的问题总结

java -jar 执行报错中没有主清单属性

Spring Boot的可执行JAR需要依赖该插件生成正确的主清单属性。在 pom.xml 的 部分添加以下配置：

<build> <plugins> <!-- 必须配置此插件才能生成可执行的Spring Boot JAR --> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <version>${spring-boot.version}</version> <!-- 版本与Spring Boot一致 --> <executions> <execution> <goals> <goal>repackage</goal> <!-- 关键：重新打包为可执行JAR --> </goals> </execution> </executions> </plugin> </plugins> </build> 我本地resource的lib包下引入了数据库的xxx的驱动包，idea运行正常，为什么打的包运行报错java.sql.SQLException: com.xxx.Driver

在 Spring Boot 项目中，如果本地手动引入第三方驱动包（如神通数据库的 oscar 驱动），但在 IDEA 中运行正常、打包后运行报 java.sql.SQLException: com.oscar.Driver 错误，通常是因为 驱动类未正确加载到打包后的 JAR 中。以下是完整的排查和解决方案：

---

1. 确认驱动包是否被打包到 JAR 中 步骤 1：解压生成的 JAR 文件

通过以下命令解压 JAR 文件（将 your-app.jar 替换为实际名称）：

jar -xvf your-app.jar

进入解压后的目录，检查 BOOT-INF/lib/ 下是否有 oscar 驱动的 JAR 文件（如 oscar-jdbc-x.x.x.jar）。

结果分析： 如果不存在：驱动包未被正确打包，需修改 Maven 配置。如果存在：驱动类名或注册方式有误，需检查代码配置。

---

2. 解决方案：确保驱动包被打包 方法一：通过 Maven 本地依赖引入（推荐）

将本地的 oscar 驱动 JAR 安装到 Maven 本地仓库，并在 pom.xml 中声明依赖。

安装驱动到本地仓库 执行以下命令（替换实际路径和版本）：

mvn install:install-file \ -Dfile=src/main/resources/lib/oscar-jdbc-x.x.x.jar \ -DgroupId=com.oscar \ -DartifactId=oscar-jdbc \ -Dversion=x.x.x \ -Dpackaging=jar

在 pom.xml 中添加依赖

<dependency> <groupId>com.oscar</groupId> <artifactId>oscar-jdbc</artifactId> <version>x.x.x</version> </dependency> 方法二：通过 system 作用域直接引入本地 JAR

在 pom.xml 中直接引用本地 JAR（需确保路径正确）：

<dependency> <groupId>com.oscar</groupId> <artifactId>oscar-jdbc</artifactId> <version>x.x.x</version> <scope>system</scope> <systemPath>${project.basedir}/src/main/resources/lib/oscar-jdbc-x.x.x.jar</systemPath> </dependency> 方法三：配置资源插件强制打包 lib 目录

如果驱动包位于 src/main/resources/lib/，需确保 Maven 资源插件将其复制到 target/classes/lib/，并配置 spring-boot-maven-plugin 包含这些 JAR。

在 pom.xml 中添加资源插件配置

<build> <plugins> <!-- 资源插件：复制 resources/lib 到 target/classes/lib --> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-resources-plugin</artifactId> <executions> <execution> <id>copy-lib</id> <phase>validate</phase> <goals> <goal>copy-resources</goal> </goals> <configuration> <outputDirectory>${project.build.directory}/classes/lib</outputDirectory> <resources> <resource> <directory>src/main/resources/lib</directory> <filtering>false</filtering> </resource> </resources> </configuration> </execution> </executions> </plugin> <!-- Spring Boot 打包插件 --> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <configuration> <!-- 确保包含 lib 目录中的 JAR --> <includeSystemScope>true</includeSystemScope> </configuration> </plugin> </plugins> </build>

重新打包并验证

mvn clean package

---

3. 检查驱动类名和注册方式

如果驱动包已正确打包，但依然报错，需确认以下两点：

3.1 驱动类名是否正确

在代码或配置中检查驱动类名是否为 com.oscar.Driver，确保与实际的驱动类名一致（某些驱动可能类名不同）。

3.2 是否显式注册驱动（可选）

在 Spring Boot 的 application.properties 或 application.yml 中配置驱动类：

# 替换为实际的驱动类名 spring.datasource.driver-class-name=com.oscar.Driver spring.datasource.url=jdbc:oscar://host:port/database spring.datasource.username=your-username spring.datasource.password=your-password

---

4. 完整示例 pom.xml <?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http:// .w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>3.1.0</version> </parent> <groupId>com.example</groupId> <artifactId>demo</artifactId> <version>0.0.1-SNAPSHOT</version> <dependencies> <!-- Spring Boot Web --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <!-- 神通数据库驱动（方法一或二） --> <dependency> <groupId>com.oscar</groupId> <artifactId>oscar-jdbc</artifactId> <version>x.x.x</version> </dependency> </dependencies> <build> <plugins> <!-- 资源插件：打包本地 JAR --> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-resources-plugin</artifactId> <executions> <execution> <id>copy-lib</id> <phase>validate</phase> <goals> <goal>copy-resources</goal> </goals> <configuration> <outputDirectory>${project.build.directory}/classes/lib</outputDirectory> <resources> <resource> <directory>src/main/resources/lib</directory> <filtering>false</filtering> </resource> </resources> </configuration> </execution> </executions> </plugin> <!-- Spring Boot 打包插件 --> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project>

---

5. 验证步骤 重新打包：mvn clean package。解压 JAR，检查 BOOT-INF/lib/ 下是否有驱动 JAR。运行 JAR：java -jar your-app.jar。

---

常见问题总结 问题原因解决方案驱动包未被打包通过 Maven 本地依赖或资源插件配置强制包含 JAR驱动类名错误检查并修正 spring.datasource.driver-class-name驱动未显式注册在配置文件中指定驱动类

如果问题仍未解决，可以检查驱动包是否与当前 Java 版本和 Spring Boot 版本兼容。