Spring Boot升级至2.7.7后Jasypt加密数据库密码绑定失败求助

核心问题分析 #

Spring Boot 2.7.x对配置解析逻辑、第三方starter兼容性做了调整，旧版本Jasypt（1.18）的加密配置和新版本starter的适配存在冲突，尤其是自定义加密算法（PBEWITHSHAAND256BITAES-CBC-BC）依赖BouncyCastle，且配置参数必须严格匹配才能正常解密。

分步解决方案 #

1. 匹配正确的依赖版本 #

Spring Boot 2.7.7需搭配jasypt-spring-boot-starter 3.0.4（官方验证兼容2.7.x的稳定版），同时必须引入BouncyCastle Provider依赖（旧加密算法的核心依赖）：

<dependency>
    <groupId>com.github.ulisesbocchio</groupId>
    <artifactId>jasypt-spring-boot-starter</artifactId>
    <version>3.0.4</version>
</dependency>
<dependency>
    <groupId>org.bouncycastle</groupId>
    <artifactId>bcprov-jdk15on</artifactId>
    <version>1.70</version>
</dependency>

2. 恢复旧加密算法的完整配置 #

不要随意修改加密算法、Provider或盐生成器，严格沿用Spring Boot 2.1.x时的有效配置：

# Jasypt加密核心配置（和旧版本完全一致）
jasypt.encryptor.algorithm=PBEWITHSHAAND256BITAES-CBC-BC
jasypt.encryptor.provider-classname=org.bouncycastle.jce.provider.BouncyCastleProvider
jasypt.encryptor.salt-generator-classname=org.jasypt.salt.RandomSaltGenerator

# 数据库密码配置（直接使用ENC标签，避免嵌套占位符解析冲突）
spring.datasource.password=ENC(xxxxxxxxxxxxxxxx)

注：原配置中的${datasource_password:ENC(...)}嵌套占位符会触发Spring Boot配置解析优先级问题，导致Jasypt无法识别ENC标签，建议直接使用纯ENC格式。

3. 正确传递加密密钥 #

使用小写的JVM参数传递密钥（新版本Jasypt默认监听小写参数名）：

# 启动应用时添加JVM参数
java -Djasypt.encryptor.password=你的加密密钥 -jar your-app.jar

若需使用环境变量传递密钥，需添加配置映射：

jasypt.encryptor.password=${JASYPT_ENCRYPTOR_PASSWORD:默认密钥}

4. 验证解密有效性 #

添加一个简单的测试Bean，确认Jasypt是否正确解密密码：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
import javax.annotation.PostConstruct;

@Component
public class PasswordDecryptTest {
    @Value("${spring.datasource.password}")
    private String decryptedPassword;

    @PostConstruct
    public void printDecryptedPassword() {
        // 仅用于测试，生产环境需删除此打印
        System.out.println("解密后的密码：" + decryptedPassword);
    }
}

启动应用后查看控制台，若打印出明文密码，说明解密逻辑正常，此时数据库连接问题大概率是URL、用户名等其他配置的问题。

5. 强制Jasypt配置优先级 #

若仍无法连接，需确保Jasypt的自动配置优先于数据源配置，在启动类添加核心注解：

@SpringBootApplication
@EnableEncryptableProperties
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

注：@EnableEncryptableProperties是Jasypt starter的核心注解，确保所有标注的配置属性被加密处理。

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