华佗
3578a24254
- 新增 MD/specs/IRON_RULES.md — 执行铁律汇总(v2.0, 8条铁律) - 新增 MD/specs/BACKEND_DEVELOPMENT_STANDARD.md — 后端开发规范 - 新增 MD/specs/FRONTEND_DEVELOPMENT_STANDARD.md — 前端开发规范 - 新增 healthlink-his-ui/AGENTS.md — 前端铁律引用 - 更新 healthlink-his-server/AGENTS.md — 同步规范文档引用 - 修复10个文档缺失的元数据(文档类型标签) - 全部30个文档通过命名规范和元数据检查
212 lines
6.3 KiB
Markdown
212 lines
6.3 KiB
Markdown
# HealthLink-HIS 后端组件升级方案
|
||
|
||
> **文档类型**: 升级记录
|
||
> **适用范围**: 后端组件
|
||
> **版本**: v1.0
|
||
|
||
> **编制日期**: 2026-06-04
|
||
> **基线**: Spring Boot 2.5.15 + MyBatis Plus 3.5.5
|
||
> **目标**: 升级安全漏洞组件 + 小版本迭代，不做大版本迁移
|
||
|
||
---
|
||
|
||
## 升级原则
|
||
|
||
1. **安全优先** — BouncyCastle 等有漏洞的组件必须升
|
||
2. **小版本优先** — 只升 patch/minor，不升 major
|
||
3. **逐个验证** — 每升一个组件跑 `mvn clean package -DskipTests` + 启动测试
|
||
4. **不动核心** — Spring Boot 2.5、MyBatis Plus 3.5 暂不升
|
||
|
||
---
|
||
|
||
## Phase 1: 安全修复（必做）
|
||
|
||
### 1.1 BouncyCastle 1.69 → 1.80 🔴
|
||
|
||
| 项 | 内容 |
|
||
|---|---|
|
||
| **风险等级** | 🔴 高 — 1.69 有 CVE 安全漏洞 |
|
||
| **变更文件** | `healthlink-his-server/pom.xml` |
|
||
| **当前值** | `<bcprov-jdk15on.version>1.69</bcprov-jdk15on.version>` |
|
||
| **操作** | 删除 jdk15on，改用 jdk18on |
|
||
| **新增依赖** | `org.bouncycastle:bcprov-jdk18on:1.80`<br>`org.bouncycastle:bcpkix-jdk18on:1.80` |
|
||
| **代码影响** | 搜索 `rg "bcprov\|bcpkix" --type java` — 当前无直接引用，仅通过依赖传递 |
|
||
| **验证** | `mvn compile` + 启动后检查登录/token 签发 |
|
||
| **回滚** | 改回 `1.69` |
|
||
|
||
**具体操作：**
|
||
```xml
|
||
<!-- 旧 -->
|
||
<bcprov-jdk15on.version>1.69</bcprov-jdk15on.version>
|
||
|
||
<!-- 新 -->
|
||
<!-- 删除 bcprov-jdk15on.version 属性 -->
|
||
<!-- 在 dependencyManagement 中添加 -->
|
||
<dependency>
|
||
<groupId>org.bouncycastle</groupId>
|
||
<artifactId>bcprov-jdk18on</artifactId>
|
||
<version>1.80</version>
|
||
</dependency>
|
||
<dependency>
|
||
<groupId>org.bouncycastle</groupId>
|
||
<artifactId>bcpkix-jdk18on</artifactId>
|
||
<version>1.80</version>
|
||
</dependency>
|
||
```
|
||
|
||
---
|
||
|
||
## Phase 2: 连接池 & 工具库升级
|
||
|
||
### 2.1 Druid 1.2.27 → 1.2.28 🟢
|
||
|
||
| 项 | 内容 |
|
||
|---|---|
|
||
| **风险** | 🟢 低 — patch 版本 |
|
||
| **变更** | `<druid.version>1.2.27</druid.version>` → `1.2.28` |
|
||
| **代码影响** | `DruidProperties.java` — API 无变化 |
|
||
| **验证** | 启动后检查 Druid 监控页 `/druid/` |
|
||
|
||
### 2.2 Fastjson2 2.0.58 → 2.0.61 🟢
|
||
|
||
| 项 | 内容 |
|
||
|---|---|
|
||
| **风险** | 🟢 低 — patch 版本 |
|
||
| **变更** | `<fastjson2.version>2.0.58</fastjson2.version>` → `2.0.61` |
|
||
| **代码影响** | 无直接引用（0 个文件），仅依赖传递 |
|
||
| **验证** | `mvn compile` |
|
||
|
||
### 2.3 Hutool 5.3.8 → 5.8.x 🟢
|
||
|
||
| 项 | 内容 |
|
||
|---|---|
|
||
| **风险** | 🟢 低 — minor 版本 |
|
||
| **变更** | `<hutool-all.version>5.3.8</hutool-all.version>` → `5.8.35` |
|
||
| **代码影响** | `rg "cn.hutool" --type java` — 约 10+ 文件使用 `ObjectUtil`、`StrUtil` |
|
||
| **验证** | 检查使用 Hutool 的业务模块（预约管理等） |
|
||
| **注意** | 5.3.8 → 5.8 跨了多个 minor，需检查 deprecated API |
|
||
|
||
---
|
||
|
||
## Phase 3: 监控 & IO 升级
|
||
|
||
### 3.1 OSHI 6.6.5 → 6.10.0 🟢
|
||
|
||
| 项 | 内容 |
|
||
|---|---|
|
||
| **风险** | 🟢 低 — minor 版本 |
|
||
| **变更** | `<oshi.version>6.6.5</oshi.version>` → `6.10.0` |
|
||
| **代码影响** | `Server.java` — 使用 `SystemInfo`、`CentralProcessor`、`GlobalMemory` |
|
||
| **验证** | 系统监控页面正常显示 CPU/内存/磁盘信息 |
|
||
| **注意** | OSHI 6.10 API 基本兼容 6.6 |
|
||
|
||
### 3.2 Commons IO 2.13.0 → 2.21.0 🟢
|
||
|
||
| 项 | 内容 |
|
||
|---|---|
|
||
| **风险** | 🟢 低 — minor 版本 |
|
||
| **变更** | `<commons.io.version>2.13.0</commons.io.version>` → `2.21.0` |
|
||
| **代码影响** | 无直接引用 |
|
||
| **验证** | `mvn compile` |
|
||
|
||
### 3.3 PostgreSQL Driver 42.2.27 → 42.7.x 🟢
|
||
|
||
| 项 | 内容 |
|
||
|---|---|
|
||
| **风险** | 🟢 低 |
|
||
| **变更** | `<postgresql.version>42.2.27</postgresql.version>` → `42.7.4` |
|
||
| **代码影响** | 无，仅 JDBC 驱动 |
|
||
| **验证** | 启动后数据库连接正常 |
|
||
|
||
---
|
||
|
||
## Phase 4: 文档 & 分页
|
||
|
||
### 4.1 Swagger → SpringDoc 1.8.x 🟡
|
||
|
||
| 项 | 内容 |
|
||
|---|---|
|
||
| **风险** | 🟡 中 — 不同库 |
|
||
| **当前** | `<swagger.version>3.0.0</swagger.version>`（springfox） |
|
||
| **目标** | springdoc-openapi 1.8.6 |
|
||
| **操作** | 替换 springfox 依赖为 springdoc |
|
||
| **代码影响** | `rg "swagger\|ApiModel\|ApiOperation" --type java` — 需改注解 |
|
||
| **建议** | ⚠️ 暂不升 — 注解改造工作量大 |
|
||
|
||
### 4.2 PageHelper 1.4.7 → 1.4.7 保持 🟢
|
||
|
||
| 项 | 内容 |
|
||
|---|---|
|
||
| **建议** | 保持当前版本 — 1.4.7 稳定且够用 |
|
||
| **原因** | 升级到 2.x 需配合 Spring Boot 4 |
|
||
|
||
---
|
||
|
||
## Phase 5: PDF & 签名
|
||
|
||
### 5.1 itextpdf 5.5.12 → 5.5.13.4 🟢
|
||
|
||
| 项 | 内容 |
|
||
|---|---|
|
||
| **风险** | 🟢 低 — patch 版本 |
|
||
| **变更** | `<itextpdf.version>5.5.12</itextpdf.version>` → `5.5.13.4` |
|
||
| **代码影响** | PDF 生成相关 |
|
||
|
||
### 5.2 Kernel 7.1.2 → 7.1.2 保持 🟢
|
||
|
||
| 项 | 内容 |
|
||
|---|---|
|
||
| **建议** | 保持 — 已是较新版本 |
|
||
|
||
---
|
||
|
||
## 执行计划
|
||
|
||
```
|
||
Day 1: Phase 1 (BouncyCastle) + Phase 2 (Druid/Fastjson2/Hutool)
|
||
→ mvn clean package -DskipTests
|
||
→ 启动测试
|
||
|
||
Day 2: Phase 3 (OSHI/PostgreSQL/Commons IO)
|
||
→ mvn clean package -DskipTests
|
||
→ 启动测试 + 系统监控验证
|
||
|
||
Day 3: Phase 5 (itextpdf)
|
||
→ mvn clean package -DskipTests
|
||
→ PDF 功能验证
|
||
```
|
||
|
||
---
|
||
|
||
## 版本对照表
|
||
|
||
| 组件 | 当前 | 升级到 | 类型 | 状态 |
|
||
|---|---|---|---|---|
|
||
| Spring Boot | 2.5.15 | 保持 | major | 🔒 暂不动 |
|
||
| MyBatis Plus | 3.5.5 | 保持 | major | 🔒 暂不动 |
|
||
| PageHelper | 1.4.7 | 保持 | major | 🔒 暂不动 |
|
||
| **BouncyCastle** | **1.69** | **1.80** | major | 🔴 **必做** |
|
||
| **Druid** | **1.2.27** | **1.2.28** | patch | 🟢 **可做** |
|
||
| **Fastjson2** | **2.0.58** | **2.0.61** | patch | 🟢 **可做** |
|
||
| **Hutool** | **5.3.8** | **5.8.35** | minor | 🟢 **可做** |
|
||
| **OSHI** | **6.6.5** | **6.10.0** | minor | 🟢 **可做** |
|
||
| **Commons IO** | **2.13.0** | **2.21.0** | minor | 🟢 **可做** |
|
||
| **PostgreSQL** | **42.2.27** | **42.7.4** | minor | 🟢 **可做** |
|
||
| **itextpdf** | **5.5.12** | **5.5.13.4** | patch | 🟢 **可做** |
|
||
| Swagger/SpringDoc | 3.0.0 | 1.8.6 | 不同库 | ⚠️ 暂不动 |
|
||
|
||
---
|
||
|
||
## 验证清单
|
||
|
||
每次升级后检查：
|
||
|
||
- [ ] `mvn clean package -DskipTests` 编译通过
|
||
- [ ] 启动无报错
|
||
- [ ] 登录功能正常
|
||
- [ ] Druid 监控页 `/druid/` 可访问
|
||
- [ ] 系统监控页正常（OSHI 升级时）
|
||
- [ ] PDF 导出正常（itextpdf 升级时）
|
||
- [ ] 数据库连接正常
|
||
|