Spring Boot打包可执行Jar失败：PostgreSQL密码认证异常求助

API 探路者

2026-5-20

问题分析与解决方案

为什么打包Jar时需要连接数据库？

其实不是打包本身需要连数据库，而是Maven的package生命周期默认会触发前面的阶段（比如test、process-resources等），或者你项目里配置的某些插件在打包过程中会尝试连接数据库执行操作：

最常见的是单元测试阶段：默认mvn package会先运行所有测试用例，如果你的测试用例里有操作数据库的代码，就会触发DB连接。
其次是Hibernate的自动DDL操作：如果你的hibernate.cfg.xml里配置了hibernate.hbm2ddl.auto为update/create/create-drop，有些Maven插件会在打包阶段自动执行这个DDL生成逻辑，导致连接数据库。
另外像Flyway、Liquibase这类数据库迁移工具，如果配置了在打包时执行迁移脚本，也会主动连接数据库。

解决方案（不用修改本地DB密码）

下面给你几个实用的解决办法，按需选择：

1. 跳过打包时的测试阶段

如果测试用例是导致DB连接的原因，直接跳过测试即可。可以在命令行执行：

mvn package -DskipTests

或者临时在pom.xml里配置跳过测试（更推荐用命令行参数，避免影响开发时的测试运行）：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <configuration>
                <skipTests>true</skipTests>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 用Maven Profiles区分环境配置（最推荐）

通过Profiles让开发环境和打包（服务器）环境使用不同的数据库配置，完全不用修改本地密码：

第一步：在src/main/resources下创建两个配置文件，比如hibernate-dev.cfg.xml（本地开发用，填你本地DB密码）和hibernate-prod.cfg.xml（服务器用，填服务器DB密码）。
第二步：在pom.xml里配置Profiles：

<profiles>
    <profile>
        <id>dev</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <build>
            <resources>
                <resource>
                    <directory>src/main/resources</directory>
                    <includes>
                        <include>hibernate-dev.cfg.xml</include>
                        <include>*.properties</include> <!-- 其他通用配置文件 -->
                    </includes>
                </resource>
            </resources>
        </build>
    </profile>
    <profile>
        <id>prod</id>
        <build>
            <resources>
                <resource>
                    <directory>src/main/resources</directory>
                    <includes>
                        <include>hibernate-prod.cfg.xml</include>
                        <include>*.properties</include> <!-- 其他通用配置文件 -->
                    </includes>
                </resource>
            </resources>
        </build>
    </profile>
</profiles>

第三步：打包时指定prod profile：

mvn package -Pprod -DskipTests

这样打包出来的Jar会加载服务器的DB配置，本地开发还是用自己的配置，互不干扰。

3. 调整Hibernate DDL配置的生效时机

如果是hibernate.hbm2ddl.auto导致的问题，你可以让这个配置只在开发环境生效：

利用上面的Profiles，在dev环境的配置里保留hibernate.hbm2ddl.auto=update，在prod环境的配置里改成hibernate.hbm2ddl.auto=none；
或者在代码里通过系统参数控制，开发时启动JVM添加参数-Dhibernate.hbm2ddl.auto=update，打包时不设置这个参数，默认使用none。

4. 禁用打包时的数据库迁移插件

如果项目用了Flyway或Liquibase，检查它们的Maven插件配置，默认可能会在package阶段执行迁移。你可以修改插件的执行阶段，或者禁用自动执行：

<!-- 以Flyway为例，禁用打包时自动执行迁移 -->
<plugin>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-maven-plugin</artifactId>
    <version>你的插件版本</version>
    <executions>
        <execution>
            <phase>none</phase> <!-- 取消自动执行，手动运行mvn flyway:migrate触发迁移 -->
        </execution>
    </executions>
</plugin>

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