Cecil Fast - 自研全平台加速器服务 | 高速稳定全球网络访问返回首页

Fastjson漏洞原理与修复方案

更新于 2026-11-09 · cecil.buzz

简答:截至2026年11月9日,官方安全公告将CVE-2026-16723的影响范围列为fastjson 1.2.68至1.2.83,首选修复是升级到1.2.84;无法立即升级时,可启用SafeMode或使用noneautotype版本。先确认实际运行版本、是否解析不可信JSON、是否符合公告列出的Spring Boot可执行fat-jar条件,再安排兼容性测试和灰度发布。

定义:Fastjson漏洞通常指在解析不可信JSON时,类型解析、AutoType或反序列化路径被利用,导致信息泄露、拒绝服务或远程代码执行等安全问题。

先看结论:版本和修复路径怎么判断

最快的判断方式是同时核对三个字段:实际加载的fastjson版本、应用是否接收不可信JSON、部署形态是否符合安全公告的触发条件。不要只看源码中的pom.xml或build.gradle,也不要因为调用了JSON.parseObject(body, SomeDto.class)就认定安全。

检查项截至本次核验可确认的信息处理建议
fastjson 版本官方公告列出1.2.68至1.2.83为CVE-2026-16723受影响范围,1.2.84为修复版本。优先升级到com.alibaba:fastjson:1.2.84,再做回归测试。
配置状态公告将AutoType关闭且SafeMode关闭列为默认配置下的受影响条件。无法马上升级时,临时启用SafeMode,并评估业务是否依赖AutoType。
部署形态公告重点描述Spring Boot可执行fat-jar模式,并说明其验证环境。检查是否通过java -jar运行,以及应用包内是否存在BOOT-INF/lib依赖。
fastjson2该CVE公告称fastjson2不受CVE-2026-16723影响;但fastjson2另有独立的AutoType加固版本要求。使用fastjson2时,按官方发布记录升级到不低于已修复独立问题的版本,并重新测试。

以上版本范围和触发条件来自Fastjson官方安全公告;CVE登记信息可在NVD条目中交叉核对。官方公告中的“受影响”是特定漏洞条件下的判断,不应被扩展为所有Fastjson项目都必然可利用。

Fastjson漏洞原理:从不可信JSON到危险类型解析

Fastjson本身是Java对象与JSON之间的序列化、反序列化库。序列化是把Java对象转换为JSON;反序列化则是把JSON还原为Java对象。问题通常出现在服务端把外部可控内容直接交给反序列化器,并允许输入影响目标类型、类加载或对象构造流程。

  1. 输入进入解析入口:HTTP请求体、消息队列、缓存数据或其他外部来源被交给JSON.parse、JSON.parseObject等入口。
  2. 类型信息参与判断:当解析逻辑处理@type或其他类型提示时,程序可能尝试判断目标类。
  3. 资源探测或类加载:在受影响代码路径中,用户可控的类型名可能进入资源探测、白名单判断或类加载过程。
  4. 对象构造产生副作用:如果类路径、配置和调用链满足条件,攻击者可能进一步触发敏感操作。具体结果取决于版本、部署方式、JDK、应用代码和可达入口。

针对CVE-2026-16723,官方公告描述的关键根因是fastjson 1.x在类型检查路径中对用户可控类型名进行资源探测;1.2.84在进入资源探测或类加载前增加了类型名校验,并同步加强白名单校验、危险基类前缀处理和类缓存逻辑。本文不提供可直接利用的恶意JSON或攻击载荷,排查时应以版本、配置、入口和运行包证据为准。

项目排查步骤:Maven、Gradle与运行包三处都要查

1. 查Maven依赖树

在项目根目录执行:

mvn dependency:tree -Dincludes=com.alibaba:fastjson

该命令用于确认直接依赖和间接依赖最终解析出的版本。Maven官方的dependency:tree目标说明见Apache Maven Dependency Plugin文档。如果结果同时出现多个版本,不能只看最上面的声明,应继续确认实际生效版本和打包结果。

2. 查Gradle依赖与版本选择原因

先查看依赖树:

./gradlew dependencies

再定位具体模块和版本选择原因:

./gradlew dependencyInsight --dependency fastjson

Gradle官方文档说明,dependencies可以输出依赖图,dependencyInsight可以定位最终选中版本及其原因,参考Gradle依赖查看文档。

3. 查实际运行的JAR包

如果应用已经打包或部署,继续检查构建产物和容器内文件,避免源码版本与运行版本不一致:

  • 查看Spring Boot可执行JAR内是否存在BOOT-INF/lib/fastjson-*.jar。
  • 检查容器镜像、发布目录和启动脚本中是否另行放置了fastjson JAR。
  • 记录启动命令、JVM参数、配置文件和实际进程的工作目录。

Spring Boot官方文档说明,可执行JAR的依赖通常位于BOOT-INF/lib,并由启动器加载;可参考Spring Boot可执行JAR结构说明。若依赖由容器、插件或自定义类加载器提供,还需要结合启动日志和类加载信息确认。

修复方案一:升级到fastjson 1.2.84并做兼容性验证

官方发布记录显示,fastjson 1.2.84是针对1.2.x线的安全修复版本,示例依赖如下:

<dependency>
  <groupId>com.alibaba</groupId>
  <artifactId>fastjson</artifactId>
  <version>1.2.84</version>
</dependency>

版本说明和安全改动见fastjson官方发布记录。升级不应只替换版本号,建议按以下顺序执行:

  1. 在测试环境锁定依赖版本,确认没有旧版JAR残留。
  2. 搜索代码和配置中的AutoType、SupportAutoType、ParserConfig、@type及自定义类型处理器。
  3. 准备包含Object、Map、集合、泛型和历史数据的回归样本。
  4. 验证正常请求、异常输入、空字段、未知字段、日期和数字类型的解析结果。
  5. 重新打包并检查运行产物,确认线上实际加载的是目标版本。
  6. 灰度发布,观察解析异常、接口错误率、进程创建、异常外联和应用日志。

成功判据:依赖树和运行包均只保留计划版本;核心接口回归通过;漏洞扫描不再报告对应受影响版本;灰度期间没有新增解析兼容性错误。

修复方案二:暂时启用SafeMode或使用noneautotype版本

如果业务暂时不能升级,可把SafeMode作为应急缓解措施,但它可能影响依赖AutoType的历史功能,不能替代最终升级。官方安全公告列出了以下方式:

  • JVM参数:-Dfastjson.parser.safeMode=true
  • 代码配置:ParserConfig.getGlobalInstance().setSafeMode(true)
  • 配置文件:在classpath中的fastjson.properties设置fastjson.parser.safeMode=true

另一个临时路径是使用官方公告列出的noneautotype构建,例如com.alibaba:fastjson:1.2.83_noneautotype。它的目标是编译期移除相关AutoType能力,但同样可能导致依赖该能力的业务不兼容。切换后必须执行完整回归,不要直接在生产环境盲目替换。

停止条件:如果启用SafeMode后出现核心接口无法解析、消息消费失败或历史数据无法读取,应暂停扩大范围,保留日志和样本,先完成兼容性评估;不要为了恢复功能而重新打开不受控的类型解析。

修复方案三:迁移fastjson2时要注意版本与API变化

fastjson2提供兼容模式和新API模式,但官方说明也明确提示并非100%兼容。fastjson2使用不同的包名和GroupId,且AutoType默认关闭。迁移时至少核对以下内容:

  • 依赖坐标是否从com.alibaba:fastjson切换到目标方案。
  • 代码导入是否仍为com.alibaba.fastjson,还是已经切换到com.alibaba.fastjson2。
  • 是否依赖循环引用检测、智能匹配、注解、日期格式或自定义序列化器等默认行为。
  • 是否显式启用了SupportAutoType或自定义AutoTypeBeforeHandler。
  • 是否需要按当前官方发布记录升级到包含安全修复的版本。

截至2026年11月9日,官方发布页显示fastjson2已有2.0.66版本;但具体采用哪个版本仍应结合项目JDK、框架和兼容性测试决定。版本信息参考fastjson2官方发布记录,迁移原则参考fastjson2官方仓库说明。

无法立即升级时的临时防护与修复后复测

如果补丁窗口尚未安排,可先降低暴露面,但这些措施不能替代依赖升级:

  • 只允许业务真正需要的JSON字段,拒绝未知字段和不符合数据类型的输入。
  • 避免把外部输入直接交给需要自动识别类型的解析入口。
  • 对外部接口、消息队列和管理端接口分别梳理数据来源及信任边界。
  • 在网络层限制应用不必要的出站访问,并按最小权限运行进程。
  • 关注异常解析失败、异常外联、进程创建、文件写入和突发错误日志。
  • 通过漏洞扫描或软件成分分析复测,并保留依赖树、镜像摘要和发布记录。

复测应覆盖两类结果:一是组件扫描不再命中受影响版本;二是业务接口在正常输入和异常输入下都符合预期。若发现已经存在异常外联或进程行为,应按安全事件流程隔离、保留证据并进一步调查,不能只把版本号改掉后结束处置。

常见问题

Fastjson 1.2.83一定会被远程利用吗?

不能仅凭版本号下结论。官方公告把1.2.68至1.2.83列为CVE-2026-16723影响范围,同时还列出了配置、输入入口和部署形态等条件。应先完成依赖、运行包、配置和部署方式核验,但对解析不可信JSON的项目,仍建议尽快升级。

把JSON解析成固定DTO是不是就安全?

不是充分条件。官方公告明确指出,指定目标Class并不能作为单独的缓解措施,DTO中的Object或Map字段仍可能扩大解析路径。应同时关闭不必要的类型能力、升级组件并限制输入。

开启SafeMode后还需要升级吗?

建议需要。SafeMode适合无法立即升级时的临时缓解,但可能带来兼容性影响,也不能替代长期依赖治理。最终应回到修复版本、回归测试和运行包复核。

fastjson2是否可以直接替换fastjson 1.x?

不能假定完全兼容。官方仓库提供兼容模式和迁移说明,但也提示需要充分测试。应先梳理API、包名、默认行为、注解和AutoType使用情况,再在测试和灰度环境验证。

只检查pom.xml或build.gradle够不够?

不够。间接依赖、依赖仲裁、容器镜像、发布目录或自定义类加载器都可能导致实际运行版本不同。至少要同时检查依赖树、构建产物和线上运行包。

常见问题

Fastjson漏洞最先应该查什么?

先查实际运行版本,再查是否解析不可信JSON、是否存在AutoType相关配置,以及应用是否符合官方公告列出的部署条件。不要只看源码声明。

Fastjson 1.2.84是唯一修复方式吗?

针对CVE-2026-16723,官方首选路径是升级到1.2.84;无法立即升级时可启用SafeMode或使用noneautotype版本,但这些方案需要评估兼容性,不能替代最终升级。

如何确认Spring Boot应用实际加载了哪个fastjson?

先执行Maven或Gradle依赖查询,再检查可执行JAR中的BOOT-INF/lib目录、容器镜像和启动日志,确认构建结果与线上运行版本一致。

修复后怎样判断已经完成?

依赖树和运行包不再包含受影响版本,核心接口回归通过,漏洞扫描复测不再命中,并且灰度期间没有新增解析异常、异常外联或进程行为。

相关阅读

参考资料

  1. Fastjson官方安全公告:1.2.68—1.2.83远程代码执行漏洞
  2. Fastjson官方发布记录:1.2.84安全修复
  3. Apache Maven Dependency Plugin:dependency:tree
  4. Gradle官方文档:查看与分析依赖
  5. Spring Boot官方文档:可执行JAR与BOOT-INF/lib结构
  6. fastjson2官方发布记录
  7. fastjson2官方仓库与升级说明