document.writeln('');

当前位置：首页 > 云服务器

如何在Linux系统中配置Java和Spring环境

游戏科技网2026年09月15日 01:30云服务器80

答案：配置Linux上Java和Spring环境需安装JDK、设置JAVA_HOME和PATH变量、安装Maven或Gradle；推荐使用OpenJDK因开源免费且系统集成度高；注意环境变量作用域、路径正确性及版本冲突；通过Spring Initializr创建项目，用Maven或Gradle构建为可执行JAR，再以java -jar运行，并处理端口、防火墙、权限等问题。

在Linux系统上配置Java和Spring环境，核心在于三步：首先是安装Java开发工具包（JDK），它是运行Java应用程序和编译代码的基础；其次是正确配置Java相关的环境变量，让系统能找到JDK；最后，通常我们会安装一个构建工具如Maven或Gradle，它们是管理Spring项目依赖和构建流程的关键。这个过程并不复杂，但有些细节，如果没留意，可能会让你多走不少弯路。

解决方案

配置Java和Spring环境，我们通常会从JDK的安装开始，然后是构建工具，最后是验证。

1. 安装Java开发工具包 (JDK)

在Linux上，OpenJDK是首选，因为它通常是开源且易于通过包管理器安装。

立即学习“Java免费学习笔记（深入）”；

使用包管理器安装 (推荐)
- Debian/Ubuntu系 (apt):
  1
  2
  sudo apt update
  sudo apt install openjdk-17-jdk # 安装OpenJDK 17，你可以根据需要选择其他版本
- CentOS/Fedora系 (yum/dnf):
  1
  2
  3
  sudo dnf install java-17-openjdk-devel # Fedora
  # 或者对于较旧的CentOS/RHEL
  sudo yum install java-17-openjdk-devel
  安装完成后，可以通过
  1
  java -version
  和
  1
  javac -version
  来验证。

手动安装 (如果需要特定版本或发行版) 从Oracle官网或Adoptium (推荐) 下载JDK的Linux

tar.gz

包。

# 假设下载到 ~/Downloads/jdk-17.0.x_linux-x64_bin.tar.gz

sudo mkdir -p /usr/local/java

sudo tar -xzf ~/Downloads/jdk-17.0.x_linux-x64_bin.tar.gz -C /usr/local/java

# 重命名目录以便管理

sudo mv /usr/local/java/jdk-17.0.x /usr/local/java/jdk-17

2. 配置环境变量

无论哪种安装方式，都需要设置

1	`JAVA_HOME`

和更新

PATH

变量。

编辑用户配置文件: 打开

1	`~/.bashrc`

或

1	`~/.profile`

(根据你的Shell和需求，

1	`~/.bashrc`

更常见于交互式Shell)。

1	`nano ~/.bashrc`

在文件末尾添加以下行：

# Java Environment Variables

export JAVA_HOME="/usr/lib/jvm/java-17-openjdk-amd64" # 根据实际安装路径调整

# 如果是手动安装，路径可能是 /usr/local/java/jdk-17

export PATH="$JAVA_HOME/bin:$PATH"

保存并退出。然后执行

1	`source ~/.bashrc`

使更改生效。验证：

1	`echo` `$JAVA_HOME`

和

1	`java -version`

。

3. 安装构建工具 (Maven 或 Gradle)

Spring项目几乎都依赖Maven或Gradle进行构建和依赖管理。

安装Maven:
- 使用包管理器:
  1
  2
  sudo apt install maven # Debian/Ubuntu
  sudo dnf install maven # Fedora/CentOS
- 手动安装: 从Maven官网下载
  1
  tar.gz
  包，解压到
  1
  /opt
  或
  1
  /usr/local
  。
  1
  2
  sudo tar -xzf ~/Downloads/apache-maven-3.x.x-bin.tar.gz -C /opt/
  sudo ln -s /opt/apache-maven-3.x.x /opt/maven # 创建软链接方便管理
  同样需要配置环境变量，在
  1
  ~/.bashrc
  中添加：
  1
  2
  export M2_HOME="/opt/maven"
  export PATH="$M2_HOME/bin:$PATH"
  1
  source ~/.bashrc
  后，通过
  1
  mvn -version
  验证。
安装Gradle (类似Maven):
- 使用包管理器:
  1
  2
  sudo apt install gradle # Debian/Ubuntu
  sudo dnf install gradle # Fedora/CentOS
- 手动安装: 从Gradle官网下载
  1
  zip
  包，解压到
  1
  /opt
  或
  1
  /usr/local
  。
  1
  2
  sudo unzip ~/Downloads/gradle-x.x.zip -d /opt/
  sudo ln -s /opt/gradle-x.x /opt/gradle
  在
  1
  ~/.bashrc
  中添加：
  1
  2
  export GRADLE_HOME="/opt/gradle"
  export PATH="$GRADLE_HOME/bin:$PATH"
  1
  source ~/.bashrc
  后，通过
  1
  gradle -v
  验证。

至此，你的Linux系统已经具备了运行和开发Spring应用的基础环境。

为什么选择OpenJDK而不是Oracle JDK？

这其实是个很实际的问题，尤其是在生产环境和持续集成/部署的场景下。简单来说，OpenJDK在Linux上的优势非常明显：

首先，许可协议的自由度。Oracle在Java 8之后对Oracle JDK的商业使用许可进行了调整，虽然个人开发和测试仍然免费，但在企业级应用中，如果需要长期支持和更新，可能就需要付费了。而OpenJDK，顾名思义，是完全开源的，基于GPLv2+CE许可，这意味着你可以在任何场景下自由使用、分发和修改，没有额外的许可成本和合规性担忧。

其次，Linux发行版的原生支持。几乎所有主流的Linux发行版，无论是Ubuntu、CentOS、Fedora还是Arch Linux，它们的官方软件仓库中都包含了OpenJDK。这意味着你可以直接通过

apt

、

yum

或

dnf

等包管理器轻松安装、更新和管理OpenJDK，享受系统级的安全更新和依赖管理。这比手动下载Oracle JDK的

.tar.gz

包然后解压、配置环境变量要省心得多，也更符合Linux的生态习惯。

再者，性能和功能上的趋同。过去，Oracle JDK在性能和一些高级特性上可能略有优势，但随着OpenJDK社区的蓬勃发展，特别是像Adoptium（前身为AdoptOpenJDK）这样的项目，它们提供的OpenJDK发行版在性能、稳定性、功能集上已经与Oracle JDK基本持平，甚至在某些方面做得更好。许多大型企业和云服务提供商也都在使用和贡献OpenJDK，这进一步证明了其可靠性。

所以，对于绝大多数在Linux上进行Java和Spring开发的场景，OpenJDK都是更明智、更便捷、风险更小的选择。我个人在Linux服务器上部署应用时，几乎总是选择OpenJDK。

配置环境变量时，我应该注意哪些常见的“坑”？

配置环境变量听起来简单，但确实有些地方稍不留神就会踩坑。我根据自己和同事们的经验，总结了几个最常见的“陷阱”：

Agent Git Oracle

高级仓库分析与重构指南。基于AI推理识别技术债务与架构反模式。

下载

一个大坑是环境变量的“作用域”问题。你可能会在

1	`/etc/profile`

、

1	`/etc/environment`

、

1	`~/.bashrc`

、

1	`~/.profile`

甚至

1	`/etc/bash.bashrc`

等多个地方看到环境变量的配置。

1
~/.bashrc
：这是针对当前用户的Bash Shell配置，每次打开新的终端会话时加载。如果你只希望当前用户使用特定的JDK，这是个好地方。但如果通过SSH执行非交互式脚本，可能就不会加载。
1
~/.profile
：这个文件在用户登录时加载，通常会调用
1
~/.bashrc
。对于图形界面登录的用户，它可能更早生效。
1
/etc/profile
：这是系统级的配置，所有用户登录时都会加载。如果你希望所有用户都能访问同一个JDK，可以考虑这里。
1
/etc/environment
：这个文件通常用于设置系统范围的环境变量，不执行任何脚本，只是简单的
1
KEY=VALUE
格式。

最常见的错误就是把配置写到了一个不生效的地方，比如在

1	`~/.bashrc`

里改了，但通过

sudo

运行命令时却发现

1	`JAVA_HOME`

没生效，因为

sudo

默认不会加载用户的环境变量。这时候可能需要在

sudo

命令前加上

1	`sudo env` `"PATH=$PATH"` `"JAVA_HOME=$JAVA_HOME"` `your_command`

，或者在

1	`/etc/profile.d/`

下创建新的脚本来设置系统级变量。

另一个常见的错误是路径配置不正确。可能是JDK的安装路径写错了，或者是

PATH

变量中没有包含

1	`$JAVA_HOME/bin`

。例如，你可能写成了

1	`export JAVA_HOME="/usr/lib/jvm/java-17"`

，但实际上可执行文件在

1	`java-17/bin`

目录下。所以，

1	`export PATH="$JAVA_HOME/bin:$PATH"`

这一步至关重要，它把JDK的

bin

目录加到系统的可执行路径中，这样你才能直接运行

java

或

javac

命令。

再有就是忘记

1	`<strong>source</strong>`

命令。修改了

1	`~/.bashrc`

或

1	`~/.profile`

后，这些更改并不会立即生效。你必须手动执行

1	`source ~/.bashrc`

或

1	`source ~/.profile`

，或者关闭并重新打开终端会话，才能让新的环境变量加载进来。很多人改完文件就直接

1	`java -version`

，然后发现没变，就以为配置失败了。

最后，版本冲突也是个隐性问题。如果你的系统安装了多个JDK版本，而

PATH

变量中包含的顺序不明确，或者

1	`update-alternatives`

等工具没有正确配置，可能会导致

1	`java -version`

报告一个版本，而实际编译时却使用了另一个版本，这在Spring项目开发中可能会引发各种奇怪的兼容性问题。通常，我会用

1	`update-alternatives --config java`

和

1	`update-alternatives --config javac`

来明确指定系统默认的JDK版本。

这些小细节，虽然看起来不值一提，但在实际操作中却能让你抓狂，所以务必仔细检查。

如何快速启动一个Spring Boot项目，并确保其在Linux上正常运行？

在Linux上快速启动并运行Spring Boot项目，其实非常直接，因为它被设计成一个自包含（self-contained）的可执行JAR包。以下是我通常的操作步骤：

1. 创建Spring Boot项目

最快捷的方式是使用 Spring Initializr (start.spring.io)。这是一个Web界面，你可以选择项目的元数据（Maven/Gradle、Java版本、Group、Artifact等）以及所需的依赖项（比如Spring Web、Spring Data JPA等）。

访问
1
start.spring.io
。
选择
1
Maven Project
或
1
Gradle Project
。
选择你的Java版本（比如
1

）。
添加
1
Spring Web
依赖。
点击
1
Generate
下载项目压缩包。

解压后，你会得到一个标准的Maven或Gradle项目结构。

2. 构建项目

进入项目根目录，使用你选择的构建工具来打包项目。

使用Maven:
1
2
cd your-spring-boot-project
mvn clean package
这个命令会清理旧的构建产物，然后编译代码、运行测试（如果存在），并将项目打包成一个可执行的JAR文件。通常，这个JAR文件会位于
1
target/
目录下，命名类似于
1
your-project-name-0.0.1-SNAPSHOT.jar
。
使用Gradle:
1
2
cd your-spring-boot-project
gradle clean build
对于Gradle，可执行JAR文件通常在
1
build/libs/
目录下，命名类似于
1
your-project-name-0.0.1-SNAPSHOT.jar
。

构建成功后，你就能看到那个自包含的JAR包了。

3. 运行Spring Boot应用

在Linux服务器上运行这个JAR包非常简单，只需要一个Java运行时环境（JRE或JDK）。

java -jar target/your-project-name-0.0.1-SNAPSHOT.jar

# 或者对于Gradle

java -jar build/libs/your-project-name-0.0.1-SNAPSHOT.jar

Spring Boot应用启动后，你会在终端看到详细的日志输出，包括它监听的端口（通常是8080）。

确保正常运行的注意事项：

端口占用： 如果你的应用默认监听8080端口，而服务器上已经有其他服务占用了这个端口，Spring Boot应用会启动失败。你可以在
1
application.properties
或
1
application.yml
中配置
1
server.port=8081
来更改端口，或者通过命令行参数
1
java -jar your-app.jar --server.port=8081
。
防火墙： 即使应用成功启动并监听了端口，如果Linux服务器的防火墙（如
1
ufw
或
1
firewalld
）没有开放该端口，外部也无法访问。你需要根据你的防火墙配置规则来开放端口，例如：
1
2
3
# 对于ufw
sudo ufw allow 8080/tcp
sudo ufw enable
1
2
3
# 对于firewalld
sudo firewall-cmd --zone=public --add-port=8080/tcp --permanent
sudo firewall-cmd --reload
权限问题： 确保运行JAR包的用户有足够的权限访问项目目录、日志文件写入目录等。虽然Spring Boot应用通常不需要特殊的系统权限，但在某些特定场景下（例如访问某些受保护的目录），这可能是个问题。
内存分配： 对于较大的Spring Boot应用，可能需要为JVM分配更多的内存。你可以在
1
java -jar
命令中添加JVM参数：
1
java -Xmx512m -Xms256m -jar target/your-project-name-0.0.1-SNAPSHOT.jar
这会设置最大堆内存为512MB，初始堆内存为256MB。
后台运行与日志管理： 在生产环境中，你通常不希望应用在前台运行。可以使用
1
nohup
命令或者
1
systemd
服务来管理Spring Boot应用：
1
2
# 使用nohup
nohup java -jar target/your-project-name-0.0.1-SNAPSHOT.jar > app.log 2>&1 &
更好的方式是创建一个
1
systemd
服务单元，这样可以更好地控制应用的启动、停止和重启，并集成到系统的日志管理中。