智能体环境配置测试
Java 17 与 SonarQube 配置启动操作文档
文档创建时间： 2025-08-11 15:30:14
操作人员： 智能体助手
操作目标： 配置Java 17环境并启动SonarQube代码质量分析平台
📋 操作概述
本文档记录了从Java环境升级到SonarQube成功启动的完整操作过程，包括环境检查、软件安装、配置调整和服务启动等关键步骤。
🔍 初始环境检查
1. Java环境状态
- 初始Java版本： OpenJDK 11.0.2
- 安装路径： C:\Users\18220\Java\jdk-11.0.2
- 问题识别： SonarQube 25.8.0需要Java 17或更高版本
2. SonarQube状态
- 版本： SonarQube 25.8.0.112029
- 安装路径： C:\迅雷下载\sonarqube-25.8.0.112029
- 初始状态： 因Java版本不兼容无法启动
🚀 操作执行过程
第一阶段：Java 17 环境配置
1.1 Java 17 安装包处理
# 解压Java 17安装包
Expand-Archive -Path 'C:\迅雷下载\Java17.zip' -DestinationPath 'C:\Users\18220\Java\' -Force
操作结果：
- ✅ 成功解压到 C:\Users\18220\Java\Java17\
- ✅ 发现安装文件：jdk-17_windows-x64_bin.exe
1.2 Java 17 安装执行
# 静默安装Java 17
Start-Process -FilePath 'C:\Users\18220\Java\Java17\jdk-17_windows-x64_bin.exe' -ArgumentList '/s' -Wait安装结果：
- ✅ 安装路径：C:\Program Files\Java\jdk-17.0.3.1
- ✅ 版本信息：Java 17.0.3.1 LTS
1.3 环境变量配置
JAVA_HOME 配置：
[Environment]::SetEnvironmentVariable('JAVA_HOME', 'C:\Program Files\Java\jdk-17.0.3.1', 'User')
$env:JAVA_HOME = 'C:\Program Files\Java\jdk-17.0.3.1'PATH 环境变量更新：
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
$newJavaPath = 'C:\Program Files\Java\jdk-17.0.3.1\bin'
$updatedPath = $newJavaPath + ';' + ($currentPath -replace 'C:\\Users\\18220\\Java\\jdk-11\.0\.2\\bin;?', '')
[Environment]::SetEnvironmentVariable('PATH', $updatedPath, 'User')验证结果：
java version "17.0.3.1" 2022-04-22 LTS
Java(TM) SE Runtime Environment (build 17.0.3.1+2-LTS-6)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.3.1+2-LTS-6, mixed mode, sharing)第二阶段：SonarQube 服务配置
2.1 SonarQube 服务安装
# 安装SonarQube Windows服务
.\SonarService.bat install安装结果：
2025-08-11 15:06:08,466 INFO - Installing service 'SonarQube (SonarQube)'...
2025-08-11 15:06:08,485 INFO - Service 'SonarQube (SonarQube)' was installed successfully.2.2 Java路径配置
# 设置SonarQube专用Java路径
[Environment]::SetEnvironmentVariable('SONAR_JAVA_PATH', 'C:\Program Files\Java\jdk-17.0.3.1\bin\java.exe', 'User')
$env:SONAR_JAVA_PATH = 'C:\Program Files\Java\jdk-17.0.3.1\bin\java.exe'2.3 服务启动
# 启动SonarQube服务
.\SonarService.bat start启动日志：
2025-08-11 15:21:04,075 INFO - Service 'SonarQube (SonarQube)' started successfully.
2025-08-11 15:21:04,080 INFO - Starting java.exe with Java 17
2025-08-11 15:21:04,220 INFO - Started process 42088✅ 最终验证结果
1. 服务状态验证
# 检查端口监听状态
Get-NetTCPConnection -LocalPort 9000结果：
LocalAddress LocalPort State
------------ --------- -----
:: 9000 Listen2. Web访问验证
# HTTP连接测试
Invoke-WebRequest -Uri 'http://localhost:9000' -TimeoutSec 5 -UseBasicParsing
结果：
- ✅ HTTP状态码：200
- ✅ 服务响应正常
- ✅ Web界面可访问
📊 配置总结
环境配置信息
| 组件 | 版本 | 安装路径 | 状态 |
|---|---|---|---|
| Java JDK | 17.0.3.1 LTS | C:\Program Files\Java\jdk-17.0.3.1 | ✅ 正常 |
| SonarQube | 25.8.0.112029 | C:\迅雷下载\sonarqube-25.8.0.112029 | ✅ 运行中 |
环境变量配置
| 变量名 | 值 | 作用 |
|---|---|---|
JAVA_HOME | C:\Program Files\Java\jdk-17.0.3.1 | Java主目录 |
SONAR_JAVA_PATH | C:\Program Files\Java\jdk-17.0.3.1\bin\java.exe | SonarQube专用Java路径 |
PATH | 包含Java 17 bin目录 | 系统命令路径 |
服务信息
- 服务名称： SonarQube (SonarQube)
- 访问地址： http://localhost:9000
- 默认登录： admin/admin（首次登录需修改密码）
- 进程ID： 42088
🔧 关键技术要点
1. Java版本兼容性
- SonarQube 25.8.0要求Java 17+
- 旧版Java 11无法启动新版SonarQube
- 需要完整卸载旧版本并安装新版本
2. 环境变量优先级
- SONAR_JAVA_PATH 优先于 JAVA_HOME
- 必须同时配置用户级和会话级环境变量
- PATH变量需要移除旧Java路径
3. Windows服务管理
- 使用 SonarService.bat 管理服务
- 服务安装后才能启动
- 服务启动需要一定时间初始化
🚨 故障排除记录
问题1：Java版本不兼容
- 现象： SonarQube启动失败，日志显示Java版本过低
- 解决： 升级到Java 17.0.3.1 LTS版本
问题2：环境变量未生效
- 现象： 服务找不到正确的Java可执行文件
- 解决： 设置 SONAR_JAVA_PATH 环境变量
问题3：服务启动缓慢
- 现象： 服务状态显示已启动但Web界面无法访问
- 解决： 等待足够时间让所有组件完全初始化
📝 操作建议
1. 环境准备
- 确保有足够的磁盘空间（至少2GB）
- 检查防火墙设置，确保9000端口可访问
- 建议使用管理员权限执行安装操作
2. 维护建议
- 定期检查SonarQube服务状态
- 监控日志文件大小，适时清理
- 建议配置自动启动服务
3. 安全建议
- 首次登录后立即修改默认密码
- 配置适当的用户权限
- 考虑启用HTTPS访问
📚 相关文档
- SonarQube官方文档
- Java 17 LTS文档
- Windows服务管理指南
文档状态： ✅ 完成
最后更新： 2025-08-11 15:30:14
操作结果： 成功配置Java 17环境并启动SonarQube服务