当前位置：首页 > 文章列表 > 文章 > java教程 > Linux下Java与Spring环境配置详解

Linux下Java与Spring环境配置详解

2025-09-26 23:12:51 0浏览收藏

golang学习网今天将给大家带来《Linux下Java与Spring环境配置教程》，感兴趣的朋友请继续看下去吧！以下内容将会涉及到等等知识点，如果你是正在学习文章或者已经是大佬级别了，都非常欢迎也希望大家都能给我建议评论哈~希望能帮助到大家！

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

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

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

解决方案

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

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

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

使用包管理器安装 (推荐)

Debian/Ubuntu系 (apt):

sudo apt update
sudo apt install openjdk-17-jdk # 安装OpenJDK 17，你可以根据需要选择其他版本

CentOS/Fedora系 (yum/dnf):

sudo dnf install java-17-openjdk-devel # Fedora
# 或者对于较旧的CentOS/RHEL
sudo yum install java-17-openjdk-devel

安装完成后，可以通过 java -version 和 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. 配置环境变量

无论哪种安装方式，都需要设置 JAVA_HOME 和更新 PATH 变量。

编辑用户配置文件: 打开 ~/.bashrc 或 ~/.profile (根据你的Shell和需求，~/.bashrc 更常见于交互式Shell)。
```
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"
```
保存并退出。然后执行 source ~/.bashrc 使更改生效。验证：echo $JAVA_HOME 和 java -version。

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

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

安装Maven:

使用包管理器:

sudo apt install maven # Debian/Ubuntu
sudo dnf install maven # Fedora/CentOS

手动安装: 从Maven官网下载 tar.gz 包，解压到 /opt 或 /usr/local。

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 # 创建软链接方便管理

同样需要配置环境变量，在 ~/.bashrc 中添加：

export M2_HOME="/opt/maven"
export PATH="$M2_HOME/bin:$PATH"

source ~/.bashrc 后，通过 mvn -version 验证。

安装Gradle (类似Maven):

使用包管理器:

sudo apt install gradle # Debian/Ubuntu
sudo dnf install gradle # Fedora/CentOS

手动安装: 从Gradle官网下载 zip 包，解压到 /opt 或 /usr/local。

sudo unzip ~/Downloads/gradle-x.x.zip -d /opt/
sudo ln -s /opt/gradle-x.x /opt/gradle

在 ~/.bashrc 中添加：

export GRADLE_HOME="/opt/gradle"
export PATH="$GRADLE_HOME/bin:$PATH"

source ~/.bashrc 后，通过 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。

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

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

一个大坑是环境变量的“作用域”问题。你可能会在 /etc/profile、/etc/environment、~/.bashrc、~/.profile 甚至 /etc/bash.bashrc 等多个地方看到环境变量的配置。

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

最常见的错误就是把配置写到了一个不生效的地方，比如在 ~/.bashrc 里改了，但通过 sudo 运行命令时却发现 JAVA_HOME 没生效，因为 sudo 默认不会加载用户的环境变量。这时候可能需要在 sudo 命令前加上 sudo env "PATH=$PATH" "JAVA_HOME=$JAVA_HOME" your_command，或者在 /etc/profile.d/ 下创建新的脚本来设置系统级变量。

另一个常见的错误是路径配置不正确。可能是JDK的安装路径写错了，或者是 PATH 变量中没有包含 $JAVA_HOME/bin。例如，你可能写成了 export JAVA_HOME="/usr/lib/jvm/java-17"，但实际上可执行文件在 java-17/bin 目录下。所以，export PATH="$JAVA_HOME/bin:$PATH" 这一步至关重要，它把JDK的 bin 目录加到系统的可执行路径中，这样你才能直接运行 java 或 javac 命令。

再有就是忘记 source 命令。修改了 ~/.bashrc 或 ~/.profile 后，这些更改并不会立即生效。你必须手动执行 source ~/.bashrc 或 source ~/.profile，或者关闭并重新打开终端会话，才能让新的环境变量加载进来。很多人改完文件就直接 java -version，然后发现没变，就以为配置失败了。

最后，版本冲突也是个隐性问题。如果你的系统安装了多个JDK版本，而 PATH 变量中包含的顺序不明确，或者 update-alternatives 等工具没有正确配置，可能会导致 java -version 报告一个版本，而实际编译时却使用了另一个版本，这在Spring项目开发中可能会引发各种奇怪的兼容性问题。通常，我会用 update-alternatives --config java 和 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等）。

访问 start.spring.io。
选择 Maven Project 或 Gradle Project。
选择你的Java版本（比如 17）。
添加 Spring Web 依赖。
点击 Generate 下载项目压缩包。

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

2. 构建项目

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

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