从具有外部数据库连接的 spring 项目构建 jar 文件

Posted 2023-02-24

【中文标题】从具有外部数据库连接的 spring 项目构建 jar 文件

【英文标题】：build jar file from a spring project with foreign database connection

【发布时间】：2019-05-26 12:18:12

【问题描述】：

我正在尝试将我的 Spring Boot 项目构建为 JAR 文件。在我的项目中，我使用本地 mysql 数据库来存储我的数据，但现在我的项目已完成并准备在 Linux 服务器上启动它，但是当我从 application.properties 更改 MySQL 连接信息，maven 无法打包项目，我收到此错误

The last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.
    at org.springframework.jdbc.datasource.DataSourceUtils.getConnection(DataSourceUtils.java:81) ~[spring-jdbc-5.1.3.RELEASE.jar:5.1.3.RELEASE]
    at org.springframework.jdbc.support.JdbcUtils.extractDatabaseMetaData(JdbcUtils.java:319) ~[spring-jdbc-5.1.3.RELEASE.jar:5.1.3.RELEASE]
    ... 88 common frames omitted
Caused by: com.mysql.cj.jdbc.exceptions.CommunicationsException: Communications link failure

The last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.
    at com.mysql.cj.jdbc.exceptions.SQLError.createCommunicationsException(SQLError.java:174) ~[mysql-connector-java-8.0.13.jar:8.0.13]
    at com.mysql.cj.jdbc.exceptions.SQLExceptionsMapping.translateException(SQLExceptionsMapping.java:64) ~[mysql-connector-java-8.0.13.jar:8.0.13]
    at com.mysql.cj.jdbc.ConnectionImpl.createNewIO(ConnectionImpl.java:835) ~[mysql-connector-java-8.0.13.jar:8.0.13]
    at com.mysql.cj.jdbc.ConnectionImpl.<init>(ConnectionImpl.java:455) ~[mysql-connector-java-8.0.13.jar:8.0.13]
    at com.mysql.cj.jdbc.ConnectionImpl.getInstance(ConnectionImpl.java:240) ~[mysql-connector-java-8.0.13.jar:8.0.13]
    at com.mysql.cj.jdbc.NonRegisteringDriver.connect(NonRegisteringDriver.java:207) ~[mysql-connector-java-8.0.13.jar:8.0.13]
    at com.zaxxer.hikari.util.DriverDataSource.getConnection(DriverDataSource.java:136) ~[HikariCP-3.2.0.jar:na]
    at com.zaxxer.hikari.pool.PoolBase.newConnection(PoolBase.java:369) ~[HikariCP-3.2.0.jar:na]
    at com.zaxxer.hikari.pool.PoolBase.newPoolEntry(PoolBase.java:198) ~[HikariCP-3.2.0.jar:na]
    at com.zaxxer.hikari.pool.HikariPool.createPoolEntry(HikariPool.java:467) ~[HikariCP-3.2.0.jar:na]
    at com.zaxxer.hikari.pool.HikariPool.checkFailFast(HikariPool.java:541) ~[HikariCP-3.2.0.jar:na]
    at com.zaxxer.hikari.pool.HikariPool.<init>(HikariPool.java:115) ~[HikariCP-3.2.0.jar:na]
    at com.zaxxer.hikari.HikariDataSource.getConnection(HikariDataSource.java:112) ~[HikariCP-3.2.0.jar:na]
    at org.springframework.jdbc.datasource.DataSourceUtils.fetchConnection(DataSourceUtils.java:151) ~[spring-jdbc-5.1.3.RELEASE.jar:5.1.3.RELEASE]
    at org.springframework.jdbc.datasource.DataSourceUtils.doGetConnection(DataSourceUtils.java:115) ~[spring-jdbc-5.1.3.RELEASE.jar:5.1.3.RELEASE]
    at org.springframework.jdbc.datasource.DataSourceUtils.getConnection(DataSourceUtils.java:78) ~[spring-jdbc-5.1.3.RELEASE.jar:5.1.3.RELEASE]
    ... 89 common frames omitted
Caused by: com.mysql.cj.exceptions.CJCommunicationsException: Communications link failure

这是我的 maven pom.xml：

<?xml version="1.0" encoding="UTF-8"?>

http://maven.apache.org/xsd/maven-4.0.0.xsd"> 4.0.0

<groupId>test</groupId>
<artifactId>TransApplication</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>jar</packaging>

<name>test</name>
<description>test</description>

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.1.1.RELEASE</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    <java.version>1.8</java.version>
    <start-class>com.trans.co.TransApplication.TransApplication</start-class>
</properties>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-rest</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-devtools</artifactId>
        <scope>runtime</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>com.google.code.gson</groupId>
        <artifactId>gson</artifactId>
    </dependency>
    <dependency>
        <groupId>org.apache.httpcomponents</groupId>
        <artifactId>httpclient</artifactId>
    </dependency>


<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>

    <dependency>
        <groupId>com.squareup.retrofit2</groupId>
        <artifactId>retrofit</artifactId>
        <version>2.3.0</version>
    </dependency>


    <dependency>
        <groupId>com.squareup.okhttp3</groupId>
        <artifactId>logging-interceptor</artifactId>
        <version>3.12.0</version>
    </dependency>
    <dependency>
        <groupId>com.squareup.retrofit2</groupId>
        <artifactId>converter-gson</artifactId>
        <version>2.3.0</version>
    </dependency>
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.16.22</version>
    </dependency>
</dependencies>

<build>

    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <transformers>
                            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                <mainClass>package.Main</mainClass>
                            </transformer>
                        </transformers>
                    </configuration>
                </execution>
            </executions>
        </plugin>

        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <executable>true</executable>
            </configuration>
        </plugin>
    </plugins>
</build>

我唯一的问题是一个简单的更改，我想更改服务器上的连接信息

【问题讨论】：

不，你不想改变它。而是在运行时使用不同的application.properties 或将属性作为参数传递。

@M.Deinum 你是什么意思“而不是运行时使用不同的”？比如更改 JAR 文件中的应用程序属性？

服务器是否已启动，是否有相同的生产数据库正在运行？关于@M.Deinum 的建议，请查看 Spring 中的配置文件。您的最终设置应该是 application-dev.properties 和 application-prd.properties 作为两个配置文件的两个属性文件的示例。

@EdwinDiaz-Mendez 都安装了相同版本的 MySQL

大多数公司处理这个问题的方法不是在 jar 中包含属性，而是将其保留在 jar 之外，或者以属性被替换（或被子集覆盖）的方式部署它外部属性文件、配置服务器或其他管理属性的东西。您通常不会为不同的部署重新编译。

【参考方案1】：

根据你的描述

maven 无法打包项目

这表明 Spring Boot Uber Jar 没有被打包，因为测试阶段在您的 Maven 生命周期中失败。一般来说，Boot Jar 应该在部署到您的服务器之前打包/组装，因此您不必担心测试失败。

如果您在服务器上构建它是为了从那里生成您的 Boot Jar 工件，那么这表明您定义的数据源配置在该环境中不适用或不正确。您要么需要跳过需要本地数据源的测试，要么提供一个可以让您的测试成功的数据源。

Spring Boot 提供了一个健壮的配置管理系统，可以根据环境进行调整，甚至可以通过运行上下文运行。事实上，您已经在使用它，并且根据您正在更改 application.properties 文件的描述，准备使用它。

高级信息详细here。特别要注意描述属性源评估顺序的部分，因为这为您提供了根据您的部署情况调整属性所需的能力。

您可以继续使用许多选项，但一般来说，我让我的开发团队配置内置于 jar 中的 application.properties 文件（默认来自主资源源集）以在默认开发环境中工作。开发人员还可以在其开发环境的工作目录中放置一个application.properties 文件，以根据他们的开发环境覆盖这些设置。也可以在构建系统或服务器上以相同的方式提供属性。通过环境变量或通过profiles 定义它们也很方便，profiles 可以基于活动配置文件配置属性定义大量它们。大型/扩展性基础架构也可以从 Spring Cloud Config 中受益，从而进一步简化这种管理。

【参考方案2】：

在你的项目的测试类上评论 //@SpringBootTest

【讨论】：

当你尝试构建一个 maven 应用程序时，Maven 将运行测试，在测试中，Spring 应用程序需要连接到数据库，这就是为什么你不能在没有数据库连接的情况下构建应用程序