# 【RuoYi-SpringBoot3-Pro】：ClassFinal 代码加密

本文详细介绍 [RuoYi-SpringBoot3-Pro](https://github.com/undsky/RuoYi-SpringBoot3-Pro) 如何使用 ClassFinal 插件保护 Java 项目的核心业务代码，防止反编译和代码泄露。

## 一、为什么需要代码加密？

Java 是一门编译型语言，源代码编译后生成的 `.class` 字节码文件可以被轻松反编译还原为接近源代码的形式。这意味着：

- 核心业务逻辑可能被竞争对手窃取
- 加密算法、授权验证等关键代码容易被破解
- 商业项目交付给客户后，源代码面临泄露风险
- 知识产权难以得到有效保护

**ClassFinal** 是一款 Java 字节码加密工具，通过对编译后的 class 文件进行深度加密，即使被反编译也只能看到乱码，从根本上保护代码安全。

## 二、ClassFinal 简介

### 2.1 核心特性

| 特性 | 说明 |
|------|------|
| 字节码加密 | 对 `.class` 文件进行 AES 加密，反编译后无法查看源代码 |
| 配置文件加密 | 支持对 `yml`、`properties` 等配置文件加密 |
| 选择性加密 | 可指定需要加密的包，避免全量加密影响性能 |
| 排除机制 | 可排除第三方库，防止加密后启动失败 |
| 密码保护 | 运行时需要提供密码，防止未授权运行 |
| Maven 集成 | 打包时自动加密，无需额外操作 |
| Spring Boot 兼容 | 完美支持 Spring Boot 项目 |

### 2.2 工作原理

```
┌─────────────────┐    Maven Package    ┌─────────────────┐
│   源代码 .java   │ ──────────────────► │  字节码 .class   │
└─────────────────┘                     └────────┬────────┘
                                                 │
                                                 ▼
                                        ┌─────────────────┐
                                        │ ClassFinal 加密  │
                                        └────────┬────────┘
                                                 │
                                                 ▼
                                        ┌─────────────────┐
                                        │ 加密后的 .class  │
                                        │  (无法反编译)    │
                                        └─────────────────┘
```

ClassFinal 在 Maven 打包阶段介入，对指定包下的 class 文件进行加密处理。加密后的 class 文件在运行时由 ClassFinal 的自定义类加载器解密并加载到 JVM 中。

## 三、项目集成

### 3.1 Maven 插件配置

在 `ruoyi-admin/pom.xml` 中添加 ClassFinal 插件：

```xml
<build>
    <plugins>
        
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>3.3.0</version>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
        
        
        <plugin>
            <groupId>com.gitee.lcm742320521</groupId>
            <artifactId>classfinal-maven-plugin</artifactId>
            <version>1.4.1</version>
            <configuration>
                
                <libjars></libjars>
                
                
                <packages>com.ruoyi.biz</packages>
                
                
                <cfgfiles>*.yml</cfgfiles>
                
                
                <excludes>org.spring</excludes>
                
                
                <password>RuoyiSpringBoot3@123456!</password>
                
                
                <code></code>
            </configuration>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>classFinal</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
    <finalName>RuoyiSpringBoot3</finalName>
</build>
```

### 3.2 配置参数详解

| 参数 | 说明 | 示例 |
|------|------|------|
| `libjars` | 需要加密的外部 jar 包 | `lib/core.jar,lib/util.jar` |
| `packages` | 需要加密的包路径 | `com.ruoyi.biz,com.ruoyi.core` |
| `cfgfiles` | 需要加密的配置文件 | `*.yml,*.properties` |
| `excludes` | 排除不加密的包 | `org.spring,org.apache` |
| `password` | 加密密码 | `YourSecretPassword` |
| `code` | 机器码，绑定特定机器运行 | `ABC123` |

### 3.3 多包加密配置

如果需要加密多个包，使用逗号分隔：

```xml
<configuration>
    <packages>com.ruoyi.biz,com.ruoyi.core,com.ruoyi.service</packages>
</configuration>
```

### 3.4 配置文件加密

支持加密敏感配置文件，防止数据库密码等信息泄露：

```xml
<configuration>
    
    <cfgfiles>*.yml,*.properties</cfgfiles>
</configuration>
```

## 四、使用步骤

### 4.1 打包加密

执行 Maven 打包命令，ClassFinal 会自动在 `package` 阶段进行加密：

```bash
# 清理并打包
mvn clean package

# 跳过测试打包
mvn clean package -DskipTests
```

打包完成后，在 `target` 目录下会生成两个文件：

```
target/
├── RuoyiSpringBoot3.jar           # 原始 jar（未加密）
└── RuoyiSpringBoot3-encrypted.jar # 加密后的 jar
```

### 4.2 运行加密的 jar

加密后的 jar 需要提供密码才能运行：

```bash
# 方式一：命令行参数
java -jar RuoyiSpringBoot3-encrypted.jar -pwd=RuoyiSpringBoot3@123456!

# 方式二：使用 --classfinal.pwd 参数
java -jar RuoyiSpringBoot3-encrypted.jar --classfinal.pwd=RuoyiSpringBoot3@123456!
```

### 4.3 验证加密效果

使用反编译工具（如 JD-GUI、IDEA）打开加密后的 jar，查看加密包下的类：

**加密前：**
```java
public class OrderService {
    public void createOrder(Order order) {
        // 完整的业务逻辑清晰可见
        validateOrder(order);
        calculatePrice(order);
        saveToDatabase(order);
    }
}
```

**加密后：**
```java
// 反编译结果为乱码或空方法体
public class OrderService {
    public void createOrder(Order order) {
        // 无法查看任何业务逻辑
    }
}
```

## 五、高级配置

### 5.1 机器码绑定

限制 jar 只能在特定机器上运行：

```xml
<configuration>
    <password>YourPassword</password>
    
    <code>MACHINE-CODE-123</code>
</configuration>
```

获取机器码：
```bash
java -jar classfinal-fatjar.jar -C
```

### 5.2 排除特定类

某些类不适合加密（如实体类、DTO），可以通过包路径排除：

```xml
<configuration>
    <packages>com.ruoyi.biz</packages>
    
    <excludes>com.ruoyi.biz.domain,com.ruoyi.biz.dto</excludes>
</configuration>
```

### 5.3 调试模式

开发阶段可以禁用加密，只在生产环境启用：

```xml
<profiles>
    <profile>
        <id>prod</id>
        <build>
            <plugins>
                <plugin>
                    <groupId>com.gitee.lcm742320521</groupId>
                    <artifactId>classfinal-maven-plugin</artifactId>
                    
                </plugin>
            </plugins>
        </build>
    </profile>
</profiles>
```

打包时指定 profile：
```bash
mvn clean package -Pprod
```

## 六、最佳实践

### 6.1 加密范围建议

| 推荐加密 | 不建议加密 |
|----------|------------|
| 核心业务逻辑 (`service`) | 实体类 (`domain`/`entity`) |
| 加密算法实现 | DTO/VO 类 |
| 授权验证代码 | Controller 层 |
| 核心算法 | 第三方库 |
| 敏感配置文件 | 公共工具类 |

### 6.2 密码安全

```java
// ❌ 不要使用简单密码
<password>123456</password>

// ✅ 使用复杂密码
<password>RuoYi@SpringBoot3#2024!Secure</password>
```

密码建议：
- 长度至少 16 位
- 包含大小写字母、数字、特殊字符
- 不要使用项目名称、公司名称等易猜测的信息
- 妥善保管，建议使用密码管理工具

### 6.3 生产环境部署

```bash
# 使用环境变量传递密码，避免密码出现在命令历史中
export CLASSFINAL_PWD="YourSecretPassword"
java -jar app.jar -pwd=$CLASSFINAL_PWD

# 或使用 nohup 后台运行
nohup java -jar app.jar -pwd=YourPassword > app.log 2>&1 &
```

### 6.4 Docker 部署

```dockerfile
FROM openjdk:17-jdk-slim

WORKDIR /app
COPY target/RuoyiSpringBoot3-encrypted.jar app.jar

# 通过环境变量传递密码
ENV CLASSFINAL_PWD=""

ENTRYPOINT ["sh", "-c", "java -jar app.jar -pwd=${CLASSFINAL_PWD}"]
```

运行容器：
```bash
docker run -e CLASSFINAL_PWD="YourPassword" -p 8080:8080 your-image
```

## 七、常见问题

### 7.1 启动报错：密码错误

```
Error: Invalid password
```

**解决方案：** 检查运行时提供的密码是否与打包时配置的密码一致。

### 7.2 启动报错：ClassNotFoundException

```
java.lang.ClassNotFoundException: com.xxx.XxxClass
```

**可能原因：**
1. 加密了不应该加密的类（如第三方库）
2. 排除配置不正确

**解决方案：** 检查 `excludes` 配置，确保第三方库被排除。

### 7.3 Spring Bean 注入失败

**可能原因：** 加密了实体类或配置类，导致 Spring 无法正确解析。

**解决方案：** 
- 不要加密 `@Entity`、`@Configuration` 等注解的类
- 只加密 Service 层的业务逻辑

### 7.4 配置文件加密后无法读取

**解决方案：** 确保运行时提供了正确的密码，ClassFinal 会自动解密配置文件。

### 7.5 热部署失效

加密后的代码不支持热部署，这是正常现象。开发阶段建议禁用加密。

## 八、注意事项

⚠️ **重要提醒：**

1. **源代码备份**：加密后的代码无法还原，请务必妥善保管源代码
2. **密码保管**：密码丢失将无法运行加密后的程序，建议多处备份
3. **测试验证**：生产部署前，务必在测试环境验证加密后的程序能正常运行
4. **性能影响**：加密会略微增加类加载时间，但运行时性能基本无影响
5. **调试困难**：加密后的代码堆栈信息可能不完整，建议保留未加密版本用于调试

## 九、适用场景

ClassFinal 代码加密特别适合以下场景：

| 场景 | 说明 |
|------|------|
| 商业软件交付 | 将软件交付给客户时保护源代码 |
| SaaS 私有化部署 | 私有化部署时防止代码泄露 |
| 核心算法保护 | 保护具有商业价值的算法实现 |
| 授权验证保护 | 防止授权验证逻辑被绕过 |
| 知识产权保护 | 保护公司的技术资产 |

## 十、总结

RuoYi-SpringBoot3-Pro 集成的 ClassFinal 代码加密功能，为 Java 项目提供了企业级的代码保护方案：

- **开箱即用**：Maven 插件集成，打包自动加密
- **安全可靠**：AES 加密算法，反编译后无法查看源代码
- **灵活配置**：支持选择性加密、排除机制、配置文件加密
- **生产就绪**：支持密码保护、机器码绑定

通过合理配置 ClassFinal，可以有效保护核心业务代码，降低代码泄露风险，为商业项目提供安全保障。

---

+ 项目地址：[RuoYi-SpringBoot3-Pro](https://github.com/undsky/RuoYi-SpringBoot3-Pro)
+ 开发文档：[RuoYi-SpringBoot3-Pro 文档](https://www.undsky.com/blog/?category=RuoYi-SpringBoot3-Pro#)

本文详细介绍 RuoYi-SpringBoot3-Pro 如何使用 ClassFinal 插件保护 Java 项目的核心业务代码，防止反编译和代码泄露。

【RuoYi-SpringBoot3-Pro】：ClassFinal 代码加密

后端

安全

开发工具

RuoYi-SpringBoot3-Pro项目集成ClassFinal插件实现Java代码加密保护，防止核心业务代码被反编译泄露。支持AES加密、选择性加密包、配置文件保护等功能，通过Maven插件一键打包加密，运行时需密码验证。适用于商业软件交付、SaaS私有化部署等场景，有效保护知识产权和敏感算法。

AES加密算法

数据库

容器

SaaS

Java

2026新春采购季

tencentdb-catalog

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

【RuoYi-SpringBoot3-Pro】：ClassFinal 代码加密-腾讯云开发者社区-腾讯云

【RuoYi-SpringBoot3-Pro】：ClassFinal 代码加密

【RuoYi-SpringBoot3-Pro】：ClassFinal 代码加密

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐