JDK 17+ 环境配置

引用文件

本文档引用的文件

• pom.xml
• yudao-dependencies/pom.xml
• .idea/misc.xml
• .idea/compiler.xml
• .idea/workspace.xml
• README.md
• yudao-module-system-biz/src/main/resources/application.yaml
• yudao-module-infra-biz/src/main/resources/application.yaml

目录

1. 简介
2. 项目结构
3. 核心组件
4. 架构概览
5. 详细组件分析
6. 依赖分析
7. 性能考虑
8. 故障排除指南
9. 结论

简介

本指南面向使用 yudao-cloud 项目的开发者，提供完整的 JDK 17+ 开发环境配置方案。该系统是一个基于 Spring Boot 3.4.1 的现代化微服务架构项目，要求 JDK 17+ 作为开发基础环境。

项目结构

yudao-cloud 项目采用模块化设计，包含网关服务和多个业务模块：

Mermaid Diagram Code:

graph TD
Root[yudao-cloud 项目根目录]
Gateway[yudao-gateway<br/>网关服务]
subgraph CoreModules [核心业务模块]
System[yudao-module-system<br/>系统基础模块]
Infra[yudao-module-infra<br/>基础设施模块]
BPM[yudao-module-bpm<br/>工作流模块]
Report[yudao-module-report<br/>报表模块]
end
subgraph IoTModules [IoT核心业务]
Device[yudao-module-device<br/>设备管理模块]
Launcher[yudao-module-launcher<br/>Launcher运营模块]
Blacklist[yudao-module-blacklist<br/>黑名单模块]
Task[yudao-module-task<br/>任务与OTA模块]
Rule[yudao-module-rule<br/>规则引擎模块]
end
Root --> Gateway
Root --> CoreModules
Root --> IoTModules

图表来源

• README.md

章节来源

• README.md

核心组件

JDK 版本要求

项目明确要求 JDK 17+ 作为开发环境：

• 核心要求: JDK 17+
• Maven 配置: 在 pom.xml 中设置 java.version 为 17
• 编译目标: 所有模块的 maven.compiler.source 和 maven.compiler.target 均设置为 17

Maven 配置

项目使用 Maven 3.6+ 作为构建工具，配置了统一的 Java 版本管理：

Mermaid Diagram Code:

flowchart TD
Start([项目构建开始]) --> CheckJDK[检查 JDK 版本 >= 17]
CheckJDK --> JDKValid{JDK版本满足要求?}
JDKValid --> |是| SetCompiler[设置编译器版本为17]
JDKValid --> |否| Error[抛出版本不兼容错误]
SetCompiler --> ConfigureMaven[配置Maven编译插件]
ConfigureMaven --> BuildProject[构建项目]
BuildProject --> End([构建完成])
Error --> End

图表来源

• pom.xml
• yudao-dependencies/pom.xml

章节来源

• pom.xml
• yudao-dependencies/pom.xml

架构概览

系统架构设计

Mermaid Diagram Code:

graph TD
User[Web/App 用户] --> Gateway[yudao-gateway 网关]
Device[智能终端设备] --> Gateway
subgraph "微服务集群 (Spring Cloud Alibaba)"
Gateway --> System[yudao-system 系统服务]
Gateway --> Infra[yudao-infra 基础服务]
Gateway --> DeviceSvc[yudao-device 设备服务]
Gateway --> Launcher[yudao-launcher 运营服务]
Gateway --> Blacklist[yudao-blacklist 黑名单服务]
Gateway --> Task[yudao-task 任务/OTA服务]
Gateway --> Rule[yudao-rule 规则引擎]
end
subgraph "中间件 & 存储"
Nacos[Nacos 注册/配置中心]
Redis[Redis 缓存]
MySQL[MySQL 业务库]
TDengine[TDengine 时序库]
Kafka[Kafka 消息队列]
end
System -.-> Nacos
DeviceSvc -.-> TDengine
Task -.-> TDengine
Blacklist -.-> Kafka
Gateway -.-> Redis

图表来源

• README.md

开发环境启动流程

Mermaid Diagram Code:

sequenceDiagram
participant Dev as 开发者
participant Maven as Maven构建工具
participant Gateway as yudao-gateway
participant Modules as 业务模块(System/Infra等)
participant Console as 控制台日志
Dev->>Maven : mvn clean install -Dmaven.test.skip=true
Maven-->>Dev : Build Success
par 启动网关
Dev->>Gateway : java -jar yudao-gateway.jar
Gateway->>Console : 打印启动 Banner
Gateway->>Console : 输出文档地址 (接口/开发/视频)
and 启动业务模块
Dev->>Modules : IDE中运行 Application 类
Modules->>Console : 打印模块特定日志
end

图表来源

• README.md

章节来源

• README.md

详细组件分析

环境变量配置

Windows 系统配置

1. 安装 JDK 17+

   • 下载并安装 OpenJDK 17 或更高版本
   • 建议使用 Eclipse Temurin 发行版

2. 配置 JAVA_HOME

   JAVA_HOME=C:\Program Files\Java\jdk-17

3. 配置 PATH 环境变量

   PATH=%JAVA_HOME%\bin;%PATH%

4. 验证安装

   java -version
   javac -version

macOS 系统配置

1. 使用 Homebrew 安装

   brew tap homebrew/cask-versions
   brew install temurin17

2. 配置 .bashrc 或 .zshrc

   export JAVA_HOME=/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home
   export PATH=$JAVA_HOME/bin:$PATH

3. 验证安装

   java -version
   javac -version

Linux 系统配置

1. 使用包管理器安装

   sudo apt update
   sudo apt install openjdk-17-jdk

2. 配置环境变量

   export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
   export PATH=$JAVA_HOME/bin:$PATH

3. 验证安装

   java -version
   javac -version

IntelliJ IDEA 配置

项目 SDK 配置

1. 打开项目设置

   • File → Project Structure → Project Settings → Project
   • 设置 Project SDK 为 JDK 17

2. 模块语言级别

   • 在 Project Structure 中设置 Language Level 为 17

3. Maven 配置

   • Maven Importing 中设置 JDK for importer 为 temurin-17
   • Maven Runner 中设置 JRE 为 temurin-17

编译器配置

Mermaid Diagram Code:

classDiagram
class ProjectRoot {
+Project SDK : JDK_17
+Language Level : 17
+Project JDK : temurin-17
}
class CompilerConfig {
+Annotation Processing : 启用
+Bytecode Target Level : 17
+Additional Options : -parameters
}
class MavenConfig {
+java.version : 17
+maven.compiler.source : 17
+maven.compiler.target : 17
}
ProjectRoot --> CompilerConfig : "继承"
CompilerConfig --> MavenConfig : "同步"

图表来源

• .idea/misc.xml
• .idea/compiler.xml
• pom.xml

章节来源

• .idea/misc.xml
• .idea/compiler.xml
• .idea/workspace.xml

Maven 配置详解

核心配置

项目在 pom.xml 中统一管理 Java 版本：

配置项	值	说明
java.version	17	核心 Java 版本
maven.compiler.source	17	源代码兼容性
maven.compiler.target	17	目标字节码版本
maven-surefire-plugin.version	3.2.2	单元测试插件
maven-compiler-plugin.version	3.13.0	编译器插件

编译参数配置

项目启用了 -parameters 编译参数以支持 Spring Boot 3.2 的参数名称发现：

Mermaid Diagram Code:

flowchart LR
Source[Java 源码] --> Compiler[maven-compiler-plugin]
Compiler --> AnnotationProcessor[注解处理器]
AnnotationProcessor --> Lombok[Lombok]
AnnotationProcessor --> MapStruct[MapStruct]
AnnotationProcessor --> SpringBootConfig[Spring Boot配置处理器]
Compiler --> Bytecode[编译后的字节码]
Bytecode --> JVM[JVM运行时]

图表来源

• pom.xml

章节来源

• pom.xml
• pom.xml

模块化项目配置

BOM 文件管理

yudao-dependencies/pom.xml 作为依赖管理文件，统一管理所有子模块的依赖版本：

Mermaid Diagram Code:

graph TD
RootPOM[pom.xml 根配置] --> DependenciesPOM[yudao-dependencies/pom.xml]
DependenciesPOM --> SpringBoot[Spring Boot 3.4.1]
DependenciesPOM --> SpringCloud[Spring Cloud 2024.0.0]
DependenciesPOM --> Alibaba[Spring Cloud Alibaba 2023.0.3.2]
DependenciesPOM --> OtherLibs[其他依赖库]
subgraph Modules
Module1[yudao-module-system]
Module2[yudao-module-infra]
Module3[yudao-module-device]
Module4[yudao-module-task]
end
DependenciesPOM --> Modules

图表来源

• yudao-dependencies/pom.xml

章节来源

• yudao-dependencies/pom.xml

依赖分析

核心依赖关系

Mermaid Diagram Code:

erDiagram
ROOT_POM {
string groupId "cn.iocoder.cloud"
string artifactId "yudao"
string version "2.4.1-SNAPSHOT"
string packaging "pom"
}
DEPENDENCIES_POM {
string groupId "cn.iocoder.cloud"
string artifactId "yudao-dependencies"
string version "2.4.1-SNAPSHOT"
string packaging "pom"
}
GATEWAY_MODULE {
string artifactId "yudao-gateway"
string packaging "jar"
}
SYSTEM_MODULE {
string artifactId "yudao-module-system"
string packaging "jar"
}
INFRA_MODULE {
string artifactId "yudao-module-infra"
string packaging "jar"
}
ROOT_POM ||--o{ DEPENDENCIES_POM : "import"
ROOT_POM ||--o{ GATEWAY_MODULE : "contains"
ROOT_POM ||--o{ SYSTEM_MODULE : "contains"
ROOT_POM ||--o{ INFRA_MODULE : "contains"

图表来源

• pom.xml
• yudao-dependencies/pom.xml

环境依赖

项目运行需要以下核心中间件：

组件	版本要求	用途
JDK	17+	开发语言基础环境
MySQL	8.0+	关系型数据库存储
Redis	5.0+	缓存与消息中间件
Nacos	2.x	注册中心与配置中心
TDengine	必须安装	时序数据库，用于日志存储
Kafka	必须安装	消息队列，用于日志上报缓冲

章节来源

• README.md

性能考虑

编译优化

1. 增量编译: 使用 Maven 3.6+ 的增量编译功能
2. 并行构建: 合理配置 Maven 并行构建参数
3. 内存配置: 为 Maven 和 IDE 配置足够的堆内存

运行时优化

1. JVM 参数: 根据项目规模调整 JVM 内存参数
2. 缓存策略: 合理配置 Redis 缓存参数
3. 数据库连接: 优化数据库连接池配置

故障排除指南

常见问题及解决方案

JDK 版本不兼容

问题: 编译时报错，提示 JDK 版本过低

解决方案:

1. 确认已安装 JDK 17+
2. 检查 JAVA_HOME 环境变量
3. 验证 Maven 使用的 JDK 版本

Maven 编译错误

问题: Maven 编译时出现版本不匹配错误

解决方案:

1. 清理 Maven 缓存
2. 更新项目依赖
3. 检查本地 Maven 配置

IntelliJ IDEA 配置问题

问题: IDE 显示编译错误，但命令行编译正常

解决方案:

1. 重新导入 Maven 项目
2. 检查项目 SDK 配置
3. 清理 IDE 缓存

验证步骤

1. 检查 JDK 版本

   java -version
   javac -version

2. 验证 Maven 配置

   mvn -version

3. 验证项目构建

   mvn clean install -DskipTests

章节来源

• .idea/misc.xml
• .idea/compiler.xml
• .idea/workspace.xml

结论

本指南提供了 yudao-cloud 项目完整的 JDK 17+ 开发环境配置方案。通过遵循本文档的配置步骤，开发者可以建立符合项目要求的开发环境，确保项目能够正确编译和运行。

关键要点包括：

• 确保 JDK 17+ 的正确安装和配置
• 配置 Maven 以使用 Java 17 进行编译
• 在 IntelliJ IDEA 中设置正确的项目 SDK 和语言级别
• 验证所有配置的正确性
• 准备必要的中间件环境

按照这些步骤配置完成后，开发者就可以顺利进行 yudao-cloud 项目的开发工作了。