高危预警 | Fastjson 再爆反序列化漏洞,无需第三方依赖即可RCE!附详细修复方案
高危预警 | Fastjson 再爆反序列化漏洞,无需第三方依赖即可RCE!附详细修复方案
背景
各位开发者、运维朋友们,注意了!
Fastjson——这个在 Java 生态中几乎"无处不在"的 JSON 处理库,再次爆出高危反序列化漏洞。该漏洞于 2026 年 7 月 20 日首次公开披露,截至发文时尚未分配 CVE 编号。
与以往不同的是,这次漏洞不依赖任何第三方 Gadget 类,仅凭 Fastjson 自身的内部逻辑就能触发远程代码执行(RCE)。
这意味着:传统的"移除危险类"缓解措施完全失效!
如果你的项目仍在使用 Fastjson 1.x,请务必认真阅读本文并尽快采取行动。
一、漏洞概述
| 项目 | 详情 |
|---|---|
| 漏洞组件 | Fastjson(阿里巴巴开源 JSON 库) |
| 影响版本 | 1.2.68 ≤ Fastjson 1.x ≤ 1.2.83 |
| 漏洞类型 | 反序列化远程代码执行(RCE) |
| 风险等级 | 🔴 高危 |
| 利用条件 | 无需特定第三方类库(Gadget-Free) |
| 安全版本 | Fastjson 2.x |
| 前提条件 | 未启用安全模式(SafeMode) |
二、漏洞原理简析
2.1 什么是 Fastjson?
Fastjson 是阿里巴巴开源的高性能 Java JSON 处理库,支持 Java 对象与 JSON 字符串之间的相互转换。凭借极致的解析性能、丰富的功能以及简单易用的 API,被广泛应用于各类 Web 和移动应用中。
2.2 漏洞核心机制
在 Fastjson 1.2.68 至 1.2.83 版本中,反序列化过程中存在一个不依赖任何特定类库(Gadget-Free) 的安全缺陷:
- 攻击者可构造特制的 JSON 负载
- 利用 Fastjson 自身内部的反序列化逻辑触发任意代码执行
- 不依赖目标应用 classpath 中是否存在特定的第三方类
2.3 为什么这次更危险?
以往 Fastjson 漏洞的利用通常需要目标环境 classpath 中存在特定的 Gadget 类(如 com.sun.rowset.JdbcRowSetImpl、TemplatesImpl 等),防御方可以通过移除或黑名单过滤这些类来缓解风险。
但本次漏洞完全绕过了这一限制:
⚠️ 攻击链完全由 Fastjson 内部逻辑构成,无需任何外部依赖,传统防御手段失效!
三、影响范围评估
3.1 受影响场景
- ✅ 使用 Fastjson 1.2.68 ~ 1.2.83 且未开启 SafeMode 的所有应用
- ✅ 存在用户可控 JSON 输入的反序列化接口(如 API 接口、消息队列消费等)
- ✅ 内部系统、微服务间通信中使用 Fastjson 进行数据交换的场景
3.2 不受影响场景
- ❌ 已启用 SafeMode 的 Fastjson 1.x 实例
- ❌ 使用 Fastjson 2.x 的应用
- ❌ 不涉及外部 JSON 输入反序列化的场景
3.3 如何检查当前版本?
# 方法一:在部署目录中搜索 jar 文件
find /opt /usr/local /home /data -name "fastjson*.jar" 2>/dev/null
# 方法二:如果是 fat jar / war 包,解压查看内部依赖
unzip -l your-app.jar | grep fastjson
# 或
jar -tf your-app.war | grep fastjson
# 方法三:查看 Maven 依赖树(开发阶段)
mvn dependency:tree -Dincludes=com.alibaba:fastjson
# 方法四:Gradle 项目
gradle dependencies --configuration runtimeClasspath | grep fastjson
# 方法五:查看运行中进程加载的 jar(应用需处于运行状态)
lsof -p <PID> | grep fastjson
四、漏洞风险
远程攻击者利用该漏洞可在目标服务器上执行任意代码,可能导致:
- 🔓 服务器被完全控制
- 📂 敏感数据泄露
- 🌐 内网横向渗透
- 💣 业务系统瘫痪
- 🔗 供应链攻击扩散
五、修复方案(详细)
🏆 方案一:迁移至 Fastjson 2.x(强烈推荐)
这是最彻底、最根本的解决方案。Fastjson 2.x 完全重构了反序列化逻辑,默认禁用 AutoType,从根本上规避了此类漏洞。
步骤 1:修改 Maven 依赖
<!-- 移除旧版依赖 -->
<!--
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.83</version>
</dependency>
-->
<!-- 添加 Fastjson2 依赖 -->
<dependency>
<groupId>com.alibaba.fastjson2</groupId>
<artifactId>fastjson2</artifactId>
<version>2.0.59</version> <!-- 请以 Maven Central 最新版本为准 -->
</dependency>
📌 最新版本查询:https://search.maven.org/artifact/com.alibaba.fastjson2/fastjson2
步骤 2:修改包名引用
Fastjson2 的包名发生了变化:
// 旧版(1.x)
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.alibaba.fastjson.JSONArray;
// 新版(2.x)
import com.alibaba.fastjson2.JSON;
import com.alibaba.fastjson2.JSONObject;
import com.alibaba.fastjson2.JSONArray;
步骤 3:API 适配(常见变化)
| 1.x 用法 | 2.x 用法 | 说明 |
|---|---|---|
JSON.parseObject(str) | JSON.parseObject(str) | 基本兼容 |
JSON.toJSONString(obj) | JSON.toJSONString(obj) | 基本兼容 |
JSONObject.parseObject(str) | JSONObject.parseObject(str) | 兼容 |
@JSONField(name="xx") | @JSONField(name="xx") | 兼容 |
ParserConfig.getGlobalInstance() | 已移除 | 需改用新配置方式 |
SerializerFeature.xxx | JSONWriter.Feature.xxx | 枚举类变更 |
Feature.xxx | JSONReader.Feature.xxx | 枚举类变更 |
步骤 4:兼容模式(降低迁移成本)
如果项目代码量大、短期无法全量迁移,可使用 Fastjson2 官方提供的 1.x API 兼容包。该包内部基于 Fastjson2 引擎,但对外仍暴露 com.alibaba.fastjson 包名,无需修改任何 import 语句即可平滑迁移:
<!-- Fastjson 1.x API 兼容包 -->
<!-- 注意:groupId 是 com.alibaba,artifactId 是 fastjson -->
<!-- 内部引擎为 Fastjson2,但 API 保持 1.x 兼容 -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>2.0.59</version> <!-- 请以最新版本为准 -->
</dependency>
⚠️ 注意区分:
com.alibaba:fastjson:2.0.x→ 1.x API 兼容包(包名不变,引擎升级为 2.x)com.alibaba.fastjson2:fastjson2→ 原生 2.x 包(新包名com.alibaba.fastjson2)两者选其一即可,不要同时引入。
步骤 5:Spring Boot 集成适配
如果项目使用 Spring MVC / Spring Boot 并需要 Fastjson 作为 HTTP 消息转换器,需额外引入 Spring 扩展模块:
<!-- Spring 5.x / Spring Boot 2.x 项目 -->
<dependency>
<groupId>com.alibaba.fastjson2</groupId>
<artifactId>fastjson2-extension-spring5</artifactId>
<version>2.0.59</version>
</dependency>
<!-- Spring 6.x / Spring Boot 3.x 项目 -->
<dependency>
<groupId>com.alibaba.fastjson2</groupId>
<artifactId>fastjson2-extension-spring6</artifactId>
<version>2.0.59</version>
</dependency>
📌 自 2.0.23 版本起,官方将 Spring 5 和 Spring 6 的支持拆分为独立模块,请根据项目实际 Spring 版本选择对应模块。
Spring Boot 配置示例:
import com.alibaba.fastjson2.JSONWriter;
import com.alibaba.fastjson2.support.spring.http.converter.FastJsonHttpMessageConverter;
import com.alibaba.fastjson2.support.config.FastJsonConfig;
@Configuration
public class Fastjson2Config implements WebMvcConfigurer {
@Override
public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter();
FastJsonConfig config = new FastJsonConfig();
config.setDateFormat("yyyy-MM-dd HH:mm:ss");
config.setWriterFeatures(JSONWriter.Feature.WriteMapNullValue);
converter.setFastJsonConfig(config);
converters.add(0, converter);
}
}
⚠️ 迁移注意事项
- 做好数据备份,避免升级过程中出现意外
- 先在测试环境充分验证,关注序列化/反序列化结果的一致性
- 注意
null值处理、日期格式、枚举序列化等行为差异 - 检查是否使用了
autoType相关功能,2.x 默认关闭 - 关注 Kotlin 项目的适配(2.x 原生支持 Kotlin)
- 如使用兼容包(步骤4),建议后续逐步将 import 迁移至
com.alibaba.fastjson2包名
🛡️ 方案二:启用安全模式 SafeMode(临时缓解)
如果短期内无法完成版本迁移,可立即启用 SafeMode 作为紧急缓解措施。
SafeMode 开启后,无论黑白名单如何配置,均完全禁用 AutoType,从根本上阻断反序列化攻击链。
方式一:代码方式启用
// 在应用启动时执行(如 Spring Boot 的 @PostConstruct 或 ApplicationRunner)
ParserConfig.getGlobalInstance().setSafeMode(true);
Spring Boot 示例:
@Component
public class FastjsonSafeModeConfig implements ApplicationRunner {
@Override
public void run(ApplicationArguments args) {
ParserConfig.getGlobalInstance().setSafeMode(true);
System.out.println("[安全加固] Fastjson SafeMode 已启用");
}
}
方式二:JVM 启动参数启用
# 在启动命令中添加
java -Dfastjson.parser.safeMode=true -jar your-app.jar
Tomcat 配置示例(catalina.sh / setenv.sh):
export CATALINA_OPTS="$CATALINA_OPTS -Dfastjson.parser.safeMode=true"
Docker 部署示例:
ENV JAVA_OPTS="-Dfastjson.parser.safeMode=true"
ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar app.jar"]
Kubernetes 部署示例:
spec:
containers:
- name: your-app
env:
- name: JAVA_OPTS
value: "-Dfastjson.parser.safeMode=true"
方式三:配置文件启用
在 classpath 下创建 fastjson.properties 文件:
fastjson.parser.safeMode=true
⚠️ SafeMode 注意事项
| 注意点 | 说明 |
|---|---|
| 业务影响评估 | 开启后 AutoType 完全失效,依赖 @type 字段进行多态反序列化的业务将受影响 |
| 版本要求 | 仅 Fastjson ≥ 1.2.68 支持 SafeMode |
| 非长久之计 | SafeMode 是缓解措施,不能替代版本升级 |
| 全面覆盖 | 确保所有服务实例都已启用,避免遗漏 |
🔍 方案三:输入校验与白名单过滤(辅助防御)
在反序列化前对 JSON 输入进行严格校验,作为纵深防御的补充手段。
3.1 检测危险字段(字符串层面预检)
public class JsonSecurityFilter {
private static final List<String> DANGEROUS_KEYS = Arrays.asList(
"@type", "@TYPE", "@Type"
);
/**
* 检测 JSON 字符串中是否包含危险的 @type 字段
* 注意:此方法在字符串层面进行预检,不触发 JSON 解析
*/
public static boolean containsDangerousType(String jsonStr) {
if (jsonStr == null || jsonStr.isEmpty()) {
return false;
}
for (String key : DANGEROUS_KEYS) {
if (jsonStr.contains("\"" + key + "\"")) {
return true;
}
}
return false;
}
/**
* 安全反序列化入口
* 前提:Fastjson SafeMode 已启用,或使用指定 Class 的反序列化方式
*/
public static <T> T safeParse(String jsonStr, Class<T> clazz) {
if (containsDangerousType(jsonStr)) {
throw new SecurityException("检测到危险的 @type 字段,拒绝反序列化");
}
return JSON.parseObject(jsonStr, clazz);
}
}
3.2 JSON Schema 校验
⚠️ 重要提示: 以下代码中的 JSON 解析操作必须在 SafeMode 已启用的前提下执行,或使用其他安全的 JSON 库(如 Jackson)进行预解析,避免校验过程本身成为攻击入口。
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.networknt.schema.JsonSchema;
import com.networknt.schema.JsonSchemaFactory;
import com.networknt.schema.SpecVersion;
import com.networknt.schema.ValidationMessage;
/**
* 使用 Jackson + networknt/json-schema-validator 进行安全校验
* 避免使用 Fastjson 解析不可信输入
*/
public class JsonSchemaValidator {
private static final ObjectMapper objectMapper = new ObjectMapper();
public static boolean validate(String jsonStr, String schemaStr) {
try {
JsonSchemaFactory factory = JsonSchemaFactory.getInstance(SpecVersion.VersionFlag.V7);
JsonSchema schema = factory.getSchema(schemaStr);
JsonNode jsonNode = objectMapper.readTree(jsonStr);
Set<ValidationMessage> errors = schema.validate(jsonNode);
return errors.isEmpty();
} catch (Exception e) {
return false;
}
}
}
3.3 WAF / 网关层拦截
在 Nginx、Spring Cloud Gateway 或 WAF 层面配置规则,拦截包含 @type 等危险字段的请求:
Nginx 配置示例:
# 拦截请求体中包含 @type 的请求
if ($request_body ~* "\"@type\"") {
return 403;
}
# 同时拦截 URL 编码变体
if ($request_body ~* "%22@type%22") {
return 403;
}
Spring Cloud Gateway 全局过滤器示例:
@Component
public class JsonSecurityGlobalFilter implements GlobalFilter, Ordered {
@Override
public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
// 对 POST/PUT 请求体进行检测
// 具体实现需结合 ServerHttpRequestDecorator 读取 body
// 检测到 "@type" 字段时返回 403
return chain.filter(exchange);
}
@Override
public int getOrder() {
return -100; // 高优先级
}
}
🔄 方案四:替换为其他 JSON 库(长期替代)
如果团队决定彻底脱离 Fastjson 生态,可考虑以下替代方案:
| 库名 | 特点 | 适用场景 |
|---|---|---|
| Jackson | Spring 生态默认集成,社区活跃,安全性好 | Spring Boot 项目首选 |
| Gson | Google 出品,轻量简洁,Android 友好 | 移动端、轻量级项目 |
| Moshi | Square 出品,Kotlin 友好 | Kotlin / Android 项目 |
Jackson 替换示例:
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.17.0</version>
</dependency>
// 替换前(Fastjson)
String json = JSON.toJSONString(user);
User user = JSON.parseObject(jsonStr, User.class);
// 替换后(Jackson)
ObjectMapper mapper = new ObjectMapper();
String json = mapper.writeValueAsString(user);
User user = mapper.readValue(jsonStr, User.class);
常见 API 对照表:
| Fastjson 1.x | Jackson | 说明 |
|---|---|---|
JSON.toJSONString(obj) | mapper.writeValueAsString(obj) | 序列化 |
JSON.parseObject(str, Clazz.class) | mapper.readValue(str, Clazz.class) | 反序列化 |
JSON.parseArray(str, Clazz.class) | mapper.readValue(str, new TypeReference<List<Clazz>>(){}) | 数组反序列化 |
JSONObject | ObjectNode / JsonNode | 动态 JSON 对象 |
@JSONField(name="xx") | @JsonProperty("xx") | 字段映射 |
@JSONField(format="yyyy-MM-dd") | @JsonFormat(pattern="yyyy-MM-dd") | 日期格式 |
六、修复优先级建议
┌─────────────────────────────────────────────────────┐
│ 紧急(24小时内) │
│ → 启用 SafeMode(方案二),立即阻断攻击面 │
├─────────────────────────────────────────────────────┤
│ 短期(1-2周) │
│ → 添加输入校验(方案三),构建纵深防御 │
├─────────────────────────────────────────────────────┤
│ 中期(1-2月) │
│ → 完成 Fastjson 2.x 迁移(方案一),根本解决问题 │
├─────────────────────────────────────────────────────┤
│ 长期(按需) │
│ → 评估是否替换为 Jackson 等库(方案四) │
└─────────────────────────────────────────────────────┘
七、排查清单 ✅
- 确认项目中 Fastjson 的版本号
- 确认是否已启用 SafeMode
- 排查所有对外暴露的 JSON 反序列化接口
- 检查是否存在用户可控的 JSON 输入
- 在测试环境验证 SafeMode 对业务的影响
- 制定 Fastjson 2.x 迁移计划
- 更新 WAF / 网关拦截规则
- 通知相关团队和上下游服务
八、总结
Fastjson 作为 Java 生态中使用最广泛的 JSON 库之一,其安全问题影响面极广。本次漏洞的 Gadget-Free 特性使其比历史漏洞更加危险——攻击者无需依赖目标环境中的任何第三方类即可实现 RCE。
核心建议:
- 立即启用 SafeMode 止血
- 尽快迁移至 Fastjson 2.x 根治
- 持续关注安全公告,建立依赖组件的安全管理机制
安全无小事,防患于未然。目前腾讯、长亭等多家安全厂商均已发布相关公告,足见其影响之广、风险之高。希望各位开发者、运维朋友们尽快排查、及时修复,守护好线上服务的安全!
文档信息
- 文章作者: 运维技术团队 - 辣个男人Devin
- 发布日期: 2026-07-20
- 适用平台: 所有运行 Fastjson 1.x 的 Java 应用(不限操作系统)
- 参考链接:
- Fastjson 官方仓库:https://github.com/alibaba/fastjson
- Fastjson2 官方仓库:https://github.com/alibaba/fastjson2
- Fastjson2 迁移文档:https://alibaba.github.io/fastjson2/
- Fastjson2 Maven Central:https://search.maven.org/artifact/com.alibaba.fastjson2/fastjson2
- 腾讯云安全通告:https://cloud.tencent.com/announce/detail/2381
- 长亭百川云通告:https://rivers.chaitin.cn/vuldb/75c81dff-8363-453e-bc7b-57bdf2d7f178
如果本文对你有帮助,欢迎点赞、在看、转发,让更多开发、运维同学们看到!
