Java开发环境部署技术文档

1. 文档概述

1.1 文档目的

本文档用于指导技术人员完成Windows、Linux系统下Java开发运行环境的标准化部署，包含JDK安装、环境变量配置、环境验证及常见故障排查，适用于开发、测试、生产服务器的Java基础环境搭建，保障Java项目正常编译、运行。

1.2 适用范围

• 操作系统：Windows 10/11、CentOS 7/8、Ubuntu 20.04/22.04
• 软件版本：JDK 8、JDK 11（企业主流长期支持版本LTS）
• 适用人员：开发工程师、运维工程师、测试工程师

1.3 环境说明

本文档默认采用Oracle JDK和OpenJDK两种部署方式，OpenJDK完全开源免费，无版权风险，优先推荐生产环境使用；Oracle JDK适用于兼容特定商业项目场景。

2. Windows系统Java环境部署

2.1 资源准备

下载对应系统架构的JDK安装包，推荐官网下载或国内镜像源下载：

• JDK8：Windows x64 压缩包/安装程序
• JDK11：Windows x64 压缩包/安装程序

本次部署以JDK11 绿色免安装版为例，无需安装，解压即可使用，配置简单、无注册表残留。

2.2 安装部署步骤

1. 解压安装包 将下载的JDK压缩包解压至纯英文无空格路径，推荐路径：D:\Software\jdk-11.0.15，禁止包含中文、空格、特殊字符，避免环境变量报错。
2. 配置系统环境变量
   1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
   2. 在「系统变量」中新建变量： 变量名：JAVA_HOME 变量值：JDK解压根目录（示例：D:\Software\jdk-11.0.15）
   3. 编辑系统变量「Path」，新增两条配置： %JAVA_HOME%\bin %JAVA_HOME%\jre\bin（JDK11及以上版本可省略，JDK8必须配置）
3. 保存配置：依次点击确定保存所有窗口配置，关闭已打开的CMD终端（旧终端不加载新环境变量）。

2.3 环境验证

重新打开CMD命令行，依次输入以下命令，输出版本信息即部署成功：

java -version
javac -version

正常输出示例：显示JDK版本号、运行环境、虚拟机信息，无「不是内部或外部命令」报错。

3. Linux系统Java环境部署

Linux系统提供两种部署方式：yum/apt在线安装（简单快捷）、压缩包手动部署（自定义版本、灵活度高）。

3.1 方式一：YUM在线安装（CentOS）

1. 更新软件源
2. 安装OpenJDK 安装JDK8：
3. 安装JDK11：
4. 自动配置环境变量：yum安装会自动注册环境变量，无需手动配置
5. 验证环境

3.2 方式二：压缩包手动部署（通用所有Linux）

1. 上传安装包：将JDK压缩包上传至服务器，推荐存放路径：/usr/local/software/
2. 创建目录并解压
3. 配置全局环境变量 编辑系统环境变量配置文件：
4. 在文件末尾追加以下配置（根据JDK路径修改）：
5. 生效环境变量
6. 验证部署结果

3.3 Ubuntu系统部署（APT方式）

# 更新源
apt update -y
# 安装JDK8
apt install openjdk-8-jdk -y
# 安装JDK11
apt install openjdk-11-jdk -y
# 验证
java -version

4. 多JDK版本切换配置

部分服务器需要同时部署JDK8和JDK11，可通过修改环境变量快速切换版本：

1. 修改/etc/profile文件，注释当前JAVA_HOME，切换为目标版本路径
2. 执行source /etc/profile生效
3. 重新执行java -version确认版本切换成功

5. 常见问题及解决方案

5.1 报错：'java' 不是内部或外部命令

原因：环境变量配置错误、路径拼写错误、未重启终端 解决方案：检查JAVA_HOME路径是否为JDK根目录，重新配置Path变量，关闭所有CMD/终端重新打开，再次验证。

5.2 Linux source配置不生效

原因：配置文件语法错误、路径不存在 解决方案：检查profile文件末尾配置是否无多余空格、换行，确认JDK解压路径真实存在，重新解压部署。

5.3 版本显示不一致

原因：系统存在多个Java版本，默认调用旧版本 解决方案：Linux执行alternatives --config java选择默认版本，Windows删除旧JDK环境变量配置。

5.4 编译工具javac不存在

原因：安装的是JRE而非JDK（仅运行环境，无编译工具） 解决方案：重新安装带devel版本的JDK，确保具备开发编译环境。

6. 环境部署验收标准

• 终端执行java -version、javac -version可正常输出版本信息，无报错
• 可正常编译Java测试类（.java）并运行生成的class文件
• 系统重启后环境变量依然生效，无需重复配置
• 无版本冲突、路径错误等异常问题

7. 附录：测试Java代码

新建Test.java文件，用于验证环境完整性：

public class Test {
    public static void main(String[] args) {
        System.out.println("Java环境部署成功！");
        System.out.println("当前JDK版本：" + System.getProperty("java.version"));
    }
}

编译运行命令：

javac Test.java
java Test

输出对应提示文字即环境完全可用。