Springboot项目(包含第三方jar包)打成war包方法

Spring Boot一般以jar包的形式发布,但是有的时候需要动态配置参数部署项目,尤其是配置的参数数量特别多时,使用war包部署实际上是一个不错的选择。以下是将Spring Boot项目打包成war包发布的详细过程。

1、修改启动类,并重写configure方法

@SpringBootApplication
@MapperScan("")
public class Application extends SpringBootServletInitializer {

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder.sources(Application.class);
    }

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }

}

说明:该修改是为了达到类似于web.xml的配置方式来启动spring上下文

2、修改pom.xml文件

2.1 修改项目发布形式

<packaging>war</packaging>

2.2 移除tomcat插件

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <!-- 移除嵌入式tomcat插件 -->
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
</dependency>

或者:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <scope>provided</scope>
</dependency>

2.3 添加servlet依赖

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>3.1.0</version>
    <scope>provided</scope>
</dependency>

2.3 编译时配置第三方jar包加载路径

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>${maven-compiler-plugin.version}</version>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <skip>true</skip>
        <encoding>UTF-8</encoding>
        <compilerArguments>
            <extdirs>${project.basedir}/src/main/resources/lib</extdirs>
        </compilerArguments>
    </configuration>
</plugin>

2.4  配置第三方jar包发布路径以及取消web.xml校验

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugin</artifactId>
    <version>3.1.0</version>
    <configuration>
        <webResources>
            <!--配置第三方jar包打包的路径-->
            <resource>
                <directory>src/main/resources/lib/</directory>
                <targetPath>WEB-INF/lib/</targetPath>
                <includes>
                    <include>**/*.jar</include>
                </includes>
            </resource>
        </webResources>
        <!-- maven打包的时候告诉maven不需要web.xml,否刚会报找不到web.xml错误 -->
        <failOnMissingWebXml>false</failOnMissingWebXml>
    </configuration>
</plugin>

另外,<build>标签下可以增加<finalName>标签标示最终war包发布的名称,如下所示:

<finalName>XXXXXXXXX</finalName>

2.5 maven命令打包 

执行mvn clean package命令即可生成war包

3、war包部署与访问

将生成war包直接部署到tomcat webapps文件夹下,直接启动tomcat即可,war会自动解压,进行发布。

注意:此时,项目中接口路径和jar包版本中的路径是不一样的,它比jar版本中的所有接口路径要多一个前缀,即"/war包解压后文件夹名/”。如果war包发布接口路径要和jar包版本路径一致,可以将解压后的war包文件夹名直接改为"ROOT",然后重启tomcat即可。

 

<think>好的,我现在需要解决用户在Spring Boot项目中将应用打WAR文件后出现的HikariDataSource连接Oracle数据库的问题,具体错误是“Failed to get driver instance for jdbcUrl=jdbc:oracle:thin”。用户之前的问题已经涉及到了驱动缺失、配置检查等方面,现在用户进一步询问关于JARWAR的区别以及如何针对WAR进行配置。我需要结合用户提供的引用内容,其中提到依赖管理和第三方库版本的问题,同时参考之前的回答来构造解决方案。 首先,用户的问题背景是使用Spring Boot构建的应用,在打WAR后出现数据库连接问题,而可能之前作为JAR运行时是正常的。需要分析JARWAR的结构差异,尤其是依赖库的存放位置,以及Tomcat等Servlet容器如何加载这些依赖。根据用户提供的引用[^1],项目中使用的是spring-boot-starter-jdbc,并且依赖了hsqldb,但用户实际使用的是Oracle数据库,所以需要确保Oracle的JDBC驱动正确包含WAR中。 接下来,用户提到在JAR下可能没有这个问题,说明在JAR时依赖被正确包含,而WAR可能结构不同。需要检查Maven或Gradle的构建配置,确保在打WAR包含Oracle驱动。特别是,WAR通常会将依赖放在WEB-INF/lib目录下,而Spring Boot的可执行JAR则使用嵌套的BOOT-INF/lib。如果构建工具配置不正确,可能会导致依赖未被正确打。 然后,需要考虑Servlet容器(如Tomcat)的类加载机制。Tomcat在加载WAR应用时,会优先使用自身的类路径,可能导致与应用内嵌的库冲突。例如,如果Tomcat的lib目录下已经有旧版本的Oracle驱动,可能会引起版本冲突,导致驱动类加载失败。需要确认应用是否排除了Tomcat自带的JDBC驱动,或者是否正确配置了类加载顺序。 此外,用户之前的回答中提到了驱动类名和JDBC URL的配置问题,需要再次确认在WAR部署时的配置文件(如application.properties或application.yml)是否正确,尤其是驱动类名是否仍为oracle.jdbc.OracleDriver,以及URL是否使用了正确的服务名格式(包含//)。 还需要考虑Spring Boot的自动配置机制。在WAR部署到外部容器时,某些自动配置可能会被禁用,需要检查数据源的配置是否正确初始化,例如是否通过@Bean显式配置了DataSource,或者在properties文件中正确指定了driver-class-name和url。 可能还需要检查构建工具(如Maven)的依赖范围,确保Oracle驱动的作用域是compile或runtime,而不是test,否则在打时可能被排除。同时,用户之前的回答中提到了Oracle驱动不在Maven中央仓库,需要手动安装或配置私有仓库,所以需要确认在打WAR时,驱动是否被正确包含。 最后,需要提供具体的步骤让用户验证,比如检查WAR内的WEB-INF/lib目录是否存在ojdbc8.jar,或者通过日志输出查看驱动是否被正确加载。同时,比较JARWAR的结构差异,帮助用户理解问题所在。</think>### 解决方案:Spring Boot WAR部署Oracle连接问题深度解析 --- #### 一、JARWAR的关键差异 | 特性 | Spring Boot JAR | WAR(传统部署) | |-----------------|------------------------------------------|--------------------------------------| | **打结构** | 内嵌Tomcat,依赖在`BOOT-INF/lib` | 依赖在`WEB-INF/lib`,需外部Servlet容器 | | **类加载机制** | 优先加载嵌套lib中的依赖 | 容器类加载器优先于应用类加载器[^1] | | **驱动加载方式** | 通过`LaunchedURLClassLoader`自动识别 | 依赖严格遵循Servlet容器规范 | | **典型场景** | 微服务独立部署 | 传统应用服务器集群部署 | --- #### 二、WAR部署的3个关键排查点 **1. 驱动打验证(核心问题)** - **Maven WAR插件配置**: ```xml <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-war-plugin</artifactId> <configuration> <!-- 确保包含非传递性依赖 --> <packagingIncludes>WEB-INF/lib/ojdbc8*.jar</packagingIncludes> </configuration> </plugin> </plugins> </build> ``` - **依赖作用域检查**: ```xml <!-- 必须为compile/runtime作用域 --> <dependency> <groupId>com.oracle.database.jdbc</groupId> <artifactId>ojdbc8</artifactId> <version>21.5.0.0</version> <scope>runtime</scope> <!-- 禁止使用test范围 --> </dependency> ``` **2. 类加载冲突排查** ```bash # 检查Tomcat的lib目录(可能包含冲突驱动) $TOMCAT_HOME/lib/ojdbc*.jar # Spring Boot排除内置Tomcat JDBC池 <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <exclusions> <exclusion> <groupId>org.apache.tomcat</groupId> <artifactId>tomcat-jdbc</artifactId> </exclusion> </exclusions> </dependency> ``` **3. 运行时配置强化** ```properties # application.properties 必须配置驱动类 spring.datasource.driver-class-name=oracle.jdbc.OracleDriver spring.datasource.url=jdbc:oracle:thin:@//host:port/service_name # 显式禁用Spring Boot的Hikari自动配置检查 spring.datasource.hikari.initialization-fail-timeout=0 ``` --- #### 三、WAR专项调试方法 **1. 结构验证命令** ```bash # 查看WAR内容 jar tf target/yourapp.war | grep ojdbc # 预期输出:WEB-INF/lib/ojdbc8-21.5.0.0.jar # 检查MANIFEST.MF unzip -p yourapp.war META-INF/MANIFEST.MF | grep Class-Path ``` **2. 启动时加载诊断** ```java @SpringBootApplication public class Application extends SpringBootServletInitializer { @PostConstruct void checkDriver() { try { Class.forName("oracle.jdbc.OracleDriver"); System.out.println("Oracle驱动加载成功"); } catch (ClassNotFoundException e) { System.err.println("驱动加载失败!"); } } } ``` **3. 容器日志分析** ```verilog # Tomcat日志中搜索异常栈 SEVERE: Failed to initialize pool: Failed to get driver instance for jdbcUrl=jdbc:oracle:thin... Caused by: java.lang.RuntimeException: oracle.jdbc.OracleDriver not loaded ``` --- #### 四、典型问题对照表 | 现象 | JAR环境 | WAR环境 | 解决方案 | |---------------------------|----------|----------|----------------------------| | 驱动类找不到 | 罕见 | 常见 | 检查WEB-INF/lib包含ojdbc | | URL格式错误 | 会报错 | 会报错 | 确认使用`@//host/service`格式 | | 容器自带驱动冲突 | 无 | 常见 | 清理$TOMCAT_HOME/lib/*.jar | | HikariCP初始化超时 | 偶发 | 高频 | 设置`initialization-fail-timeout=0` | --- #### 五、部署流程图解 ```mermaid graph TD A[构建WAR] --> B{ojdbc8.jar是否在WEB-INF/lib?} B -->|否| C[检查maven依赖配置] B -->|是| D{Tomcat lib目录有冲突驱动?} D -->|是| E[移除容器中的ojdbc*.jar] D -->|否| F[检查JDBC URL格式] F -->|错误| G[修正为@//host/service格式] F -->|正确| H[查看Hikari日志] ``` --- ### 引用说明 当使用WAR部署时,Spring Boot的自动配置机制会因`ServletInitializer`的存在而改变初始化顺序[^1]。这与JAR的嵌入式容器启动流程有本质区别,需特别注意驱动加载时机。 ---
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值