Spring Boot 项目摆设与开机自启详解

Spring Boot 项目有两种摆设方式：

• 保举：直接运行 JAR 包（无需安装外部 Tomcat，Spring Boot 内嵌容器，设置更简单）；
  
• WAR 包摆设（需禁用内嵌 Tomcat，适配外部 Tomcat）。
  

下面优先讲更简单的 JAR 包摆设+开机自启，再增补 WAR 包适配要点。
方式1：Spring Boot JAR 包摆设（保举）

条件

• 当地已将 Spring Boot 项目打包为 xxx.jar（可通过 mvn clean package 或 IDE 打包）；
  
• 服务器已安装 Java 17（你已完成）。
  

步调1：上传 JAR 包到服务器

1. # 创建应用目录（规范管理）
2. sudo mkdir -p /opt/springboot-app
4. # 上传 JAR 包（替换为你的 JAR 包名和服务器IP）
5. scp your-app.jar admin@你的服务器IP:/opt/springboot-app/
7. # 给 JAR 包执行权限
8. sudo chmod +x /opt/springboot-app/your-app.jar

复制代码

步调2：创建 systemd 服务文件（开机自启焦点）

1. sudo nano /etc/systemd/system/springboot-app.service

复制代码

粘贴以下设置（根据你的实际情况修改）：

1. [Unit]
2. Description=Spring Boot Application
3. After=network.target  # 网络启动后再启动应用
5. [Service]
6. # 运行用户（避免 root 运行，提升安全性）
7. User=admin
8. Group=admin
10. # 应用目录
11. WorkingDirectory=/opt/springboot-app
13. # Java 启动命令（指定 JAR 包，配置 JVM 参数）
14. ExecStart=/usr/bin/java -jar /opt/springboot-app/your-app.jar \
15.           -Xms512M -Xmx1024M  # JVM 内存配置，根据服务器配置调整
17. # 重启策略（异常退出时自动重启）
18. Restart=on-failure
19. RestartSec=5  # 重启间隔 5 秒
21. # 日志输出（可选，也可依赖 Spring Boot 自身日志）
22. StandardOutput=append:/opt/springboot-app/app.log
23. StandardError=append:/opt/springboot-app/app-error.log
25. [Install]
26. WantedBy=multi-user.target  # 多用户模式下开机自启

复制代码

生存退出（Ctrl+O → 回车 → Ctrl+X）。
步调3：设置并启动服务

1. # 重新加载 systemd 配置
2. sudo systemctl daemon-reload
4. # 启动应用服务
5. sudo systemctl start springboot-app
7. # 设置开机自启
8. sudo systemctl enable springboot-app
10. # 查看服务状态（确认是否启动成功）
11. sudo systemctl status springboot-app

复制代码

如果状态表现 active (running)，分析启动乐成。
步调4：验证应用访问

访问 http://你的服务器IP:应用端口/接口路径（端口是你 Spring Boot 设置的 server.port，默认 8080），能正常访问接口即摆设乐成。
方式2：Spring Boot WAR 包摆设（适配外部 Tomcat）

如果必须用 WAR 包摆设到外部 Tomcat，须要先修改 Spring Boot 项目代码，再按之前的 Tomcat 摆设步调利用：
步调1：当地项目修改（关键适配）

• 修改 pom.xml：
  1. <packaging>war</packaging>
  3. <dependency>
  4.     <groupId>org.springframework.boot</groupId>
  5.     <artifactId>spring-boot-starter-tomcat</artifactId>
  6.     <scope>provided</scope>
  7. </dependency>
  9. <dependency>
  10.     <groupId>org.springframework.boot</groupId>
  11.     <artifactId>spring-boot-starter-web</artifactId>
  12. </dependency>

  复制代码
• 修改启动类：
  
• 让启动类继续 SpringBootServletInitializer 并重写 configure 方法：
  1. import org.springframework.boot.SpringApplication;
  2. import org.springframework.boot.autoconfigure.SpringBootApplication;
  3. import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;
  5. @SpringBootApplication
  6. public class YourAppApplication extends SpringBootServletInitializer {
  7.     @Override
  8.     protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
  9.         return application.sources(YourAppApplication.class);
  10.     }
  12.     public static void main(String[] args) {
  13.         SpringApplication.run(YourAppApplication.class, args);
  14.     }
  15. }

  复制代码
• 打包 WAR 包：
  
• 实验 mvn clean package，天生的 WAR 包在 target 目次下。
  

步调2：服务器摆设

按之前给你的 Tomcat 摆设步调利用：

• 将 WAR 包上传到 Tomcat 的 webapps 目次；
  
• 设置 Tomcat 的 systemd 服务并设置开机自启；
  
• 访问路径：http://服务器IP:Tomcat端口/WAR包名/接口路径。
  

常用运维下令

1. # 重启 Spring Boot 应用
2. sudo systemctl restart springboot-app
4. # 停止应用
5. sudo systemctl stop springboot-app
7. # 查看应用日志（Spring Boot 自身日志，默认在应用目录下）
8. tail -f /opt/springboot-app/logs/xxx.log  # 或你配置的日志路径
10. # 查看系统服务日志
11. journalctl -u springboot-app -f

复制代码

总结

• 保举方案：Spring Boot 优先用 JAR 包摆设，无需外部 Tomcat，通过 systemd 设置服务即可实现开机自启，步调更简单；
  
• WAR 包适配：需修改项目 pom.xml（禁用内嵌 Tomcat）和启动类（继续 SpringBootServletInitializer），再摆设到外部 Tomcat；
  
• 自启焦点：通过 systemd 服务文件设置 ExecStart 启动下令、Restart 重启战略，实验 enable 开启开机自启。