新手求助：Ubuntu 22.04上运行Github xxpay4pro Spring Boot项目全流程

第一步：确定项目所需JDK版本 #

xxpay4pro是Spring Boot项目，先查看项目根目录下的pom.xml（Maven）或build.gradle（Gradle）文件：

• 打开文件后搜索java.version，比如看到<java.version>17</java.version>就需要JDK 17；<java.version>11</java.version>则需要JDK 11。
• 一般Spring Boot 3.x要求JDK 17及以上，Spring Boot 2.x通常支持JDK 8/11。

第二步：安装对应版本的JDK #

以JDK 17为例，用Ubuntu官方源安装OpenJDK：

1. 更新软件源：

   sudo apt update
   

2. 安装OpenJDK 17：

   sudo apt install openjdk-17-jdk openjdk-17-jre
   

3. 验证安装：

   java -version
   javac -version
   

   输出显示openjdk version "17.x.x"即为成功。

若需其他版本，替换命令里的版本号即可（比如openjdk-11-jdk）。

第三步：配置环境变量（可选但推荐） #

1. 打开环境变量配置文件：

   sudo nano /etc/profile
   

2. 在文件末尾添加以下内容（替换17为你的JDK版本）：

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

3. 保存退出（Ctrl+O，回车，Ctrl+X），使配置生效：

   source /etc/profile
   

4. 验证：

   echo $JAVA_HOME
   

   输出对应路径即为成功。

第四步：配置VS Code的Java开发环境 #

1. 打开VS Code，安装必备插件：
   • Extension Pack for Java（Java开发核心插件集合）
   • Spring Boot Extension Pack（Spring Boot开发工具，支持自动补全、调试）
2. 打开xxpay4pro项目文件夹：点击左侧“文件”>“打开文件夹”，选择项目根目录。
3. 等待VS Code自动加载项目依赖，右下角提示下载Maven/Gradle依赖时，点击“允许”即可。

第五步：运行项目 #

方式1：VS Code界面运行 #

1. 找到src/main/java下的启动类（通常类名带Application，比如XxPayApplication.java）。
2. 右键点击该类，选择“运行Java”，或点击类代码上方的“运行”按钮。
3. 终端输出出现Started XxPayApplication in X seconds时，项目启动成功。

方式2：终端命令运行 #

Maven项目：

cd 项目根目录
./mvnw spring-boot:run

Gradle项目：

cd 项目根目录
./gradlew bootRun

第六步：部署项目 #

方式1：打包Jar包部署 #

1. 打包项目：
   • Maven：

     ./mvnw clean package -DskipTests
     

   • Gradle：

     ./gradlew clean build -x test
     

   打包后Jar包生成在target（Maven）或build/libs（Gradle）目录，文件名类似xxpay4pro-xxx.jar。
2. 运行Jar包：

   java -jar target/xxpay4pro-xxx.jar
   

   后台运行：

   nohup java -jar target/xxpay4pro-xxx.jar > app.log 2>&1 &
   

   日志会输出到app.log文件。

方式2：systemd服务部署（生产环境推荐） #

1. 创建systemd服务文件：

   sudo nano /etc/systemd/system/xxpay4pro.service
   

2. 写入以下内容（替换Jar包路径和用户名）：

   [Unit]
   Description=xxpay4pro Service
   After=network.target
   
   [Service]
   User=你的用户名
   ExecStart=/usr/bin/java -jar /path/to/xxpay4pro-xxx.jar
   Restart=always
   RestartSec=5
   StandardOutput=append:/var/log/xxpay4pro.log
   StandardError=append:/var/log/xxpay4pro-error.log
   
   [Install]
   WantedBy=multi-user.target
   

3. 重新加载systemd：

   sudo systemctl daemon-reload
   

4. 启动服务并设置开机自启：

   sudo systemctl start xxpay4pro
   sudo systemctl enable xxpay4pro
   

5. 查看服务状态：

   sudo systemctl status xxpay4pro
   

内容的提问来源于stack exchange，提问作者VietThanh Sai