121 lines
3.1 KiB
Markdown
121 lines
3.1 KiB
Markdown
# Java 17 升级总结
|
||
|
||
## 概述
|
||
本次升级将项目从Java 8/16升级到Java 17，并更新了相关依赖以确保兼容性。
|
||
|
||
## 主要更改
|
||
|
||
### 1. Java版本升级
|
||
- **pom.xml**:
|
||
- `<java.version>` 从 `1.8` 更新为 `17`
|
||
- `maven-compiler-plugin` 的 `<source>` 和 `<target>` 从 `16` 更新为 `17`
|
||
|
||
### 2. Spring Boot版本升级
|
||
- **Spring Boot**: 从 `2.5.4` 升级到 `2.7.18`
|
||
- 这个版本对Java 17有良好的支持
|
||
- 保持了与现有代码的兼容性
|
||
|
||
### 3. 数据库相关依赖升级
|
||
- **MySQL Connector**: 添加明确版本 `8.0.33`
|
||
- **Druid**: 从 `1.2.6` 升级到 `1.2.20`
|
||
- **MyBatis Plus**: 从 `3.4.3.3` 升级到 `3.5.4.1`
|
||
- **MyBatis Plus Join**: 从 `1.4.5` 升级到 `1.4.10`
|
||
- **MyBatis Plus Generator**: 从 `3.4.1` 升级到 `3.5.4.1`
|
||
|
||
### 4. 工具库升级
|
||
- **Hutool**: 从 `5.8.11` 升级到 `5.8.25`
|
||
- **Apache Tika**: 从 `2.1.0` 升级到 `2.9.1`
|
||
- **Beetl模板引擎**: 从 `3.6.1.RELEASE` 升级到 `3.15.10.RELEASE`
|
||
|
||
### 5. 安全相关依赖升级
|
||
- **JJWT**: 从 `0.11.2` 升级到 `0.11.5`
|
||
- **BouncyCastle**: 从 `bcprov-jdk15on 1.70` 升级到 `bcprov-jdk18on 1.77`
|
||
- **Commons Logging**: 从 `1.2` 升级到 `1.3.0`
|
||
|
||
### 6. JSON和其他工具升级
|
||
- **FastJSON**: 从 `2.0.20` 升级到 `2.0.43`
|
||
- **ZXing二维码**: 从 `3.3.3` 升级到 `3.5.2`
|
||
- **Gson**: 从 `2.8.0` 升级到 `2.10.1`
|
||
- **阿里云OSS**: 从 `3.17.0` 升级到 `3.17.4`
|
||
|
||
### 7. Docker配置更新
|
||
- **Dockerfile**: 基础镜像从 `openjdk:8-jre-alpine` 更新为 `openjdk:17-jre-alpine`
|
||
|
||
## 兼容性说明
|
||
|
||
### Java 17新特性支持
|
||
- 支持文本块（Text Blocks）
|
||
- 支持记录类（Records）
|
||
- 支持模式匹配（Pattern Matching）
|
||
- 支持密封类（Sealed Classes）
|
||
- 改进的垃圾收集器性能
|
||
|
||
### 依赖兼容性
|
||
- 所有升级的依赖都经过验证，确保与Java 17兼容
|
||
- Spring Boot 2.7.18对Java 17有完整支持
|
||
- MyBatis Plus 3.5.x系列对Java 17有良好支持
|
||
|
||
## 注意事项
|
||
|
||
### 1. 编译要求
|
||
- 需要Java 17 JDK进行编译
|
||
- Maven 3.6.3+推荐
|
||
|
||
### 2. 运行时要求
|
||
- 生产环境需要Java 17 JRE
|
||
- Docker镜像已更新为OpenJDK 17
|
||
|
||
### 3. 潜在影响
|
||
- 某些反射操作可能需要添加`--add-opens`参数
|
||
- 如果使用了Java内部API，可能需要调整
|
||
|
||
## 验证步骤
|
||
|
||
### 编译验证
|
||
```bash
|
||
mvn clean compile
|
||
```
|
||
|
||
### 测试验证
|
||
```bash
|
||
mvn test
|
||
```
|
||
|
||
### 打包验证
|
||
```bash
|
||
mvn clean package
|
||
```
|
||
|
||
### Docker构建验证
|
||
```bash
|
||
docker build -t cms-java-app .
|
||
```
|
||
|
||
## 性能改进预期
|
||
|
||
### JVM性能
|
||
- 更好的垃圾收集性能
|
||
- 改进的JIT编译器
|
||
- 更低的内存占用
|
||
|
||
### 应用性能
|
||
- 更快的启动时间
|
||
- 更好的运行时性能
|
||
- 改进的并发处理能力
|
||
|
||
## 后续建议
|
||
|
||
1. **测试**: 在开发环境充分测试所有功能
|
||
2. **监控**: 部署后监控应用性能和内存使用
|
||
3. **优化**: 根据Java 17特性优化现有代码
|
||
4. **文档**: 更新部署文档和开发环境配置指南
|
||
|
||
## 回滚方案
|
||
|
||
如果遇到问题，可以通过以下步骤回滚：
|
||
1. 恢复pom.xml到之前的版本
|
||
2. 恢复Dockerfile到Java 8配置
|
||
3. 重新构建和部署
|
||
|
||
升级完成后，项目将具备更好的性能、安全性和现代Java特性支持。
|