Spring Boot 使用Jasypt加密的完整例子_Java

一、配置jasypt

1.在pom.xml中导入依赖

        <!-- jasypt 加密工具 -->
        <dependency>
            <groupid>com.github.ulisesbocchio</groupid>
            <artifactid>jasypt-spring-boot-starter</artifactid>
            <version>3.0.5</version>
        </dependency>

注释：项目使用了@springbootapplication或@enableautoconfiguration注解，可以直接使用starter依赖，否则要用其他方法。其他方法见参考文章里。

2.配置jasypt信息

2.1 使用@configuration配置信息

package com.xj.util.jasypt;
import org.jasypt.encryption.stringencryptor;
import org.jasypt.encryption.pbe.pooledpbestringencryptor;
import org.jasypt.encryption.pbe.config.simplestringpbeconfig;
import org.springframework.beans.factory.annotation.value;
import org.springframework.context.annotation.bean;
import org.springframework.context.annotation.configuration;
/**
 * @author: xjfu
 * @create: 2025/07/16 15:13
 * @description: jastpt配置信息
 */
@configuration
public class jasyptconfig {
    @value("${jasypt.encryptor.password:default-secret-key}")
    private string password;
    /**
     * 配置jasypt加密器
     *
     * @return stringencryptor加密器实例
     */
    @bean("jasyptstringencryptor")
    public stringencryptor stringencryptor() {
        pooledpbestringencryptor encryptor = new pooledpbestringencryptor();
        simplestringpbeconfig config = new simplestringpbeconfig();
        // 设置加密密钥 通过配置阐述，安全
        config.setpassword(password);
        //设置加密秘钥 直接写死，但是不安全
        //config.setpassword("xj20250716");
        // 设置加密算法
        // 注意：jasypt 3.0.0之后默认算法为pbewithhmacsha512andaes_256
        // 需要jdk 9+或添加jce支持，否则可能报错
        // 如果使用较低版本的jdk，可以选择兼容的算法如pbewithmd5anddes
        config.setalgorithm("pbewithmd5anddes");
        // 设置密钥获取迭代次数
        config.setkeyobtentioniterations("1000");
        // 设置加密器的池大小
        config.setpoolsize("1");
        // 设置随机盐生成器
        config.setivgeneratorclassname("org.jasypt.iv.randomivgenerator");
        // 设置字符串输出格式
        config.setstringoutputtype("base64");
        encryptor.setconfig(config);
        return encryptor;
    }
}

2.2 使用配置文件方式

# jasypt配置（必须放在最前面）
jasypt:
    encryptor:
        bean: jasyptstringencryptor
        # 可以使用环境变量或命令行参数传入密钥
        password: ${jasypt_encryptor_password:default-secret-key}
        algorithm: pbewithmd5anddes
        iv-generator-classname: org.jasypt.iv.randomivgenerator

2.3 配置文件详解

3.jasypt工具类

package com.xj.util.jasypt;
import org.jasypt.encryption.stringencryptor;
import org.springframework.beans.factory.annotation.autowired;
import org.springframework.beans.factory.annotation.qualifier;
import org.springframework.stereotype.component;
/**
 * @author: xjfu
 * @create: 2025/07/16 15:15
 * @description: jasypt工具类
 */
@component
public class jasyptutil {
    private final stringencryptor encryptor;
    @autowired
    public jasyptutil(@qualifier("jasyptstringencryptor") stringencryptor encryptor) {
        this.encryptor = encryptor;
    }
    /**
     * 加密方法
     *
     * @param value 待加密的字符串
     * @return 加密后的字符串
     */
    public string encrypt(string value) {
        return encryptor.encrypt(value);
    }
    /**
     * 解密方法
     *
     * @param value 待解密的字符串
     * @return 解密后的字符串
     */
    public string decrypt(string value) {
        return encryptor.decrypt(value);
    }
}

4.配置jasypt的秘钥

4.1 idea中配置

4.1.1 配置方法一

--jasypt.encryptor.password=xj20250716

4.1.2 配置方法二

-djasypt.encryptor.password=xj20250716

4.2 程序启动时命令行中带入

方式一：作为程序启动时的命令行参数来带入
java -jar app.jar --jasypt.encryptor.password=xxxxxx

方式二：作为程序启动时的应用环境变量来带入
java -djasypt.encryptor.password=xxxxxx -jar app.jar

5.使用enc()包裹加密密文

jasypt使用特定格式来标识加密的属性值。在配置文件中，加密的值需要使用enc(加密后的值)格式。

二、项目举例

1.项目架构

2.代码实现

mainapplication.java:

package com.xj.main;
import org.mybatis.spring.annotation.mapperscan;
import org.springframework.boot.springapplication;
import org.springframework.boot.autoconfigure.springbootapplication;
import org.springframework.context.annotation.componentscan;
/**
 * @author : xjfu
 * @date : 2022/6/8 8:38
 * @description :spring boot 启动类
 */
@componentscan("com.xj")
@springbootapplication
@mapperscan("com.xj.dao.mapper")
public class mainapplication {
    public static void main(string[] args) {
        try{
            springapplication.run(mainapplication.class, args);
        }catch (exception e){
            e.printstacktrace();
        }
    }
}

jasyptconfig.java:

package com.xj.util.jasypt;
import org.jasypt.encryption.stringencryptor;
import org.jasypt.encryption.pbe.pooledpbestringencryptor;
import org.jasypt.encryption.pbe.config.simplestringpbeconfig;
import org.springframework.beans.factory.annotation.value;
import org.springframework.context.annotation.bean;
import org.springframework.context.annotation.configuration;
/**
 * @author: xjfu
 * @create: 2025/07/16 15:13
 * @description: jastpt配置信息
 */
@configuration
public class jasyptconfig {
    @value("${jasypt.encryptor.password:default-secret-key}")
    private string password;
    /**
     * 配置jasypt加密器
     *
     * @return stringencryptor加密器实例
     */
    @bean("jasyptstringencryptor")
    public stringencryptor stringencryptor() {
        pooledpbestringencryptor encryptor = new pooledpbestringencryptor();
        simplestringpbeconfig config = new simplestringpbeconfig();
        // 设置加密密钥 通过配置阐述，安全
        config.setpassword(password);
        //设置加密秘钥 直接写死，但是不安全
        //config.setpassword("xj20250716");
        // 设置加密算法
        // 注意：jasypt 3.0.0之后默认算法为pbewithhmacsha512andaes_256
        // 需要jdk 9+或添加jce支持，否则可能报错
        // 如果使用较低版本的jdk，可以选择兼容的算法如pbewithmd5anddes
        config.setalgorithm("pbewithmd5anddes");
        // 设置密钥获取迭代次数
        config.setkeyobtentioniterations("1000");
        // 设置加密器的池大小
        config.setpoolsize("1");
        // 设置随机盐生成器
        config.setivgeneratorclassname("org.jasypt.iv.randomivgenerator");
        // 设置字符串输出格式
        config.setstringoutputtype("base64");
        encryptor.setconfig(config);
        return encryptor;
    }
}

jasyptutil.java:

package com.xj.util.jasypt;
import org.jasypt.encryption.stringencryptor;
import org.springframework.beans.factory.annotation.autowired;
import org.springframework.beans.factory.annotation.qualifier;
import org.springframework.stereotype.component;
/**
 * @author: xjfu
 * @create: 2025/07/16 15:15
 * @description: jasypt工具类
 */
@component
public class jasyptutil {
    private final stringencryptor encryptor;
    @autowired
    public jasyptutil(@qualifier("jasyptstringencryptor") stringencryptor encryptor) {
        this.encryptor = encryptor;
    }
    /**
     * 加密方法
     *
     * @param value 待加密的字符串
     * @return 加密后的字符串
     */
    public string encrypt(string value) {
        return encryptor.encrypt(value);
    }
    /**
     * 解密方法
     *
     * @param value 待解密的字符串
     * @return 解密后的字符串
     */
    public string decrypt(string value) {
        return encryptor.decrypt(value);
    }
}

jasyptcontroller.java:

package com.xj.controller;
import com.xj.entity.jasyptrequest;
import com.xj.util.jasypt.jasyptutil;
import org.springframework.beans.factory.annotation.autowired;
import org.springframework.beans.factory.annotation.value;
import org.springframework.web.bind.annotation.*;
/**
 * @author: xjfu
 * @create: 2025/07/16 15:18
 * @description: jasypt控制类，用于对铭文进行加密或者解密以及验证数据库密码
 */
@requestmapping(value = "/jasypt",method = requestmethod.post)
@restcontroller
public class jasyptcontroller {
    @autowired
    private jasyptutil jasyptutil;
    @value("${spring.datasource.password}")
    private string databasepassword;
    /**
     * 加密接口
     */
    @requestmapping(value = "/encrypt", method = requestmethod.get)
    public string encrypt(@requestparam string encryptstr) {
        return jasyptutil.encrypt(encryptstr);
    }
    /**
     * 解密接口
     */
    @requestmapping(value = "/decrypt", method = requestmethod.post)
    public string decrypt(@requestbody jasyptrequest jasyptrequest) {
        return jasyptutil.decrypt(jasyptrequest.getdecryptstr());
    }
    /**
     * 测试配置文件中的加密属性是否正确解密
     */
    @getmapping("/test")
    public string test() {
        return "database password: " + databasepassword;
    }
}

jasyptrequest.java:

package com.xj.entity;
import com.fasterxml.jackson.annotation.jsonproperty;
import lombok.data;
import java.io.serializable;
/**
 * @author: xjfu
 * @create: 2025/07/16 15:25
 * @description: jasypt解密请求体
 */
@data
public class jasyptrequest implements serializable {
    private static final long serialversionuid = -256451235446545l;
    /**
     *  待解密字符串
     */
    @jsonproperty(value = "decryptstr")
    private string decryptstr;
    public string getdecryptstr() {
        return decryptstr;
    }
    public void setdecryptstr(string decryptstr) {
        this.decryptstr = decryptstr;
    }
}

application.yml

#默认配置
server:
    port: 8080
# jasypt配置（必须放在最前面）
#jasypt:
#    encryptor:
#        bean: jasyptstringencryptor
#        # 可以使用环境变量或命令行参数传入密钥
#        password: ${jasypt_encryptor_password:default-secret-key}
#        algorithm: pbewithmd5anddes
#        iv-generator-classname: org.jasypt.iv.randomivgenerator
# 未加密版本
#spring:
#    datasource: #数据源连接信息
#        username: root
#        password: 12345
#        url: jdbc:mysql://127.0.0.1:3306/demo?useunicode=true&characterencoding=utf-8
#        driver-class-name: com.mysql.cj.jdbc.driver
#    profiles:
#        active: dev #切换配置,指定使用哪个profile
# 加密版本
spring:
    datasource: #数据源连接信息
        username: enc(x86cv+ch9gptzw7sfcz+g5nxyuepsmnb)
        password: enc(to+okisxa20ld80vojwtjdbpf0vf31/x)
        url: jdbc:mysql://127.0.0.1:3306/demo?useunicode=true&characterencoding=utf-8
        driver-class-name: com.mysql.cj.jdbc.driver
    profiles:
        active: dev #切换配置,指定使用哪个profile
# 设置 mybatis 的 xml 保存路径
mybatis-plus:
    mapper-locations: classpath:mapper/*mapper.xml
    type-aliases-package: com.xj.dao.model
    configuration: # 配置打印 mybatis 执行的 sql
        log-impl: org.apache.ibatis.logging.stdout.stdoutimpl #需要lombok框架支持，可以添加
# 配置打印 mybatis 执行的 sql
logging:
    level:
        com:
            example:
                demo: debug
---
#开发环境
server:
    port: 8081
spring:
    config:
        activate:
            on-profile: dev
---
#测试环境
server:
    port: 8082
spring:
    config:
        activate:
            on-profile: test
---
#生产环境
server:
    port: 8083
spring:
    config:
        activate:
            on-profile: prod
logging:
    config: classpath:logback-spring.xml #指定使用哪个日志配置文件

pom.xml

<?xml version="1.0" encoding="utf-8"?>
<project xmlns="http://maven.apache.org/pom/4.0.0" xmlns:xsi="http://www.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>
  <groupid>com.xj</groupid>
  <artifactid>springbootstudyproject</artifactid>
  <version>1.0-snapshot</version>
    <parent>
        <groupid>org.springframework.boot</groupid>
        <artifactid>spring-boot-starter-parent</artifactid>
        <version>2.4.5</version>
        <relativepath/>
    </parent>
    <dependencies>
        <dependency>
            <groupid>org.springframework.boot</groupid>
            <artifactid>spring-boot-starter-web</artifactid>
        </dependency>
        <dependency>
            <groupid>org.springframework.boot</groupid>
            <artifactid>spring-boot-starter-test</artifactid>
            <scope>test</scope>
        </dependency>
        <!--导入jdbc的场景启动器-->
        <dependency>
            <groupid>org.springframework.boot</groupid>
            <artifactid>spring-boot-starter-data-jdbc</artifactid>
        </dependency>
        <dependency>
            <groupid>org.springframework.boot</groupid>
            <artifactid>spring-boot-configuration-processor</artifactid>
            <optional>true</optional>
        </dependency>
        <!--jquery引入-->
        <dependency>
            <groupid>org.webjars</groupid>
            <artifactid>jquery</artifactid>
            <version>3.6.0</version>
        </dependency>
        <!--thymeleaf 启动器-->
        <dependency>
            <groupid>org.springframework.boot</groupid>
            <artifactid>spring-boot-starter-thymeleaf</artifactid>
        </dependency>
        <!--导入数据库驱动-->
        <dependency>
            <groupid>mysql</groupid>
            <artifactid>mysql-connector-java</artifactid>
            <scope>runtime</scope>
        </dependency>
        <!-- mybatis plus-->
        <dependency>
            <groupid>com.baomidou</groupid>
            <artifactid>mybatis-plus-boot-starter</artifactid>
            <version>3.4.1</version>
        </dependency>
        <!-- junit测试依赖 -->
        <dependency>
            <groupid>junit</groupid>
            <artifactid>junit</artifactid>
            <scope>test</scope>
        </dependency>
        <!-- lombok依赖 为了简化实体类的编写代码量 -->
        <dependency>
            <groupid>org.projectlombok</groupid>
            <artifactid>lombok</artifactid>
        </dependency>
        <!-- jasypt 加密工具 -->
        <dependency>
            <groupid>com.github.ulisesbocchio</groupid>
            <artifactid>jasypt-spring-boot-starter</artifactid>
            <version>3.0.5</version>
        </dependency>
    </dependencies>
    <!--build标签描述了如何来编译及打包项目，而具体的编译和打包工作是通过build中配置的 plugin 来完成-->
    <build>
        <plugins>
            <!--使用springboot的打包插件-->
            <plugin>
                <groupid>org.springframework.boot</groupid>
                <artifactid>spring-boot-maven-plugin</artifactid>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

3.运行结果

3.1 先将数据库按明文启动，然后获取对应的加密密文

3.1.1 加密

加密url:

http://127.0.0.1:8081/jasypt/encrypt?encryptstr=root

3.1.2 解密验证

解密url:

http://127.0.0.1:8081/jasypt/decrypt

报文：

{

"decryptstr":"x86cv+ch9gptzw7sfcz+g5nxyuepsmnb"

}

3.2 再将加密密文用enc()包裹起来替换明文，若启动成功，即为加密成功。

替换：

启动成功：

三、重点说明

1.若解密失败，会包如下错误

2.秘钥最好不要有特殊字符，比如“$”、"_"，这样会导致解密失败，实测经验

3.解密jasyptcontroller中的decrypt不应该用@getmapping，因为解密中的字符春包含很多特殊字符，比如“/”,“+”等，这些都会导致解密失败。@requestmapping + @requestparam也不行，必须用@requestmapping + @requestbody。