diff --git a/docs/evidence/bugfix/2026-07-29-fastjson-2.0.63-upgrade.md b/docs/evidence/bugfix/2026-07-29-fastjson-2.0.63-upgrade.md
new file mode 100644
index 0000000..79d16ff
--- /dev/null
+++ b/docs/evidence/bugfix/2026-07-29-fastjson-2.0.63-upgrade.md
@@ -0,0 +1,65 @@
+# fastjson 2.0.63 升级验证记录
+
+日期：2026-07-29
+
+## 背景
+
+后端工程当前通过 `water-backend/sw-dependencies/pom.xml` 统一管理 `com.alibaba:fastjson` 版本。本次按要求将 `fastjson` 从 `2.0.62` 升级到 `2.0.63`，继续使用 `com.alibaba:fastjson` 的 fastjson2 兼容包，保持现有 `com.alibaba.fastjson.*` 调用方式不变。
+
+## 变更
+
+修改文件：
+
+- `water-backend/sw-dependencies/pom.xml`
+
+版本属性：
+
+```xml
+<fastjson.version>2.0.63</fastjson.version>
+```
+
+## 验证
+
+执行 fastjson 兼容性单测：
+
+```bash
+mvn -pl sw-framework/sw-common -am -Dtest=FastjsonCompatibilityTest test
+```
+
+结果：
+
+```text
+Tests run: 3, Failures: 0, Errors: 0, Skipped: 0
+BUILD SUCCESS
+```
+
+执行依赖树确认：
+
+```bash
+mvn -pl sw-framework/sw-common -Dincludes=com.alibaba:fastjson dependency:tree
+```
+
+结果：
+
+```text
+com.alibaba:fastjson:jar:2.0.63:compile
+BUILD SUCCESS
+```
+
+执行 diff 空白检查：
+
+```bash
+git diff --check -- sw-dependencies/pom.xml
+```
+
+结果：无输出，命令退出码为 0。
+
+## 已知提示
+
+验证过程中 Maven 仍输出既有工程模型 warning，包括：
+
+- `sw-module-iot-biz` 中 `sw-spring-boot-starter-biz-tenant` 依赖重复声明。
+- `sw-module-iot-plugin-mqtt` 中 `maven-deploy-plugin` 缺少版本声明。
+- `sw-business-server`、`sw-business-bank-server` 中 `spring-boot-maven-plugin` 缺少版本声明。
+
+上述 warning 与本次 `fastjson` 版本升级无关，本次未修改这些模块。