<think>我们正在处理一个关于如何将Ruoyi-Cloud
项目模块打
包成
WAR文件并在
CentOS 7的
Tomcat上
部署的问题。根据用户提供的引用信息，我们了解到Ruoyi
项目是一个前后端分离的
项目，并且有相关的
部署步骤。但是，用户的问题是关于ruoyi-cloud
项目的，这是一个微服务架构的
项目，通常使用Spring Cloud，因此
部署方式可能与传统的
WAR包部署有所不同。
然而，用户明确要求将模块打
包成
WAR文件并
部署到
Tomcat。在微服务架构中，每个微服务通常可以打
包成可执行的JAR文件（使用内嵌
Tomcat）或
WAR文件（
部署到外部
Tomcat）。因此，我们可以将每个微服务模块打
包成
WAR文件。
步骤概述：
1. 修改每个需要
部署为
WAR的模块的pom.xml，将打
包方式设置为
war，并排除内嵌的
Tomcat（避免与外部
Tomcat冲突）。
2. 配置每个模块的启动类，使其继承SpringBootServletInitializer，以支持在外部
Tomcat中启动。
3. 使用Maven进行打
包，生成
WAR文件。
4. 将
WAR文件
部署到
CentOS 7上的
Tomcat服务器中。
5. 启动
Tomcat服务。
详细步骤：
### 1. 修改pom.xml
在每个需要打
包成
WAR的微服务模块的pom.xml中，修改打
包方式：
```xml
<packaging>
war</packaging>
```
并排除内嵌的
Tomcat依赖：
```xml
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-
tomcat</artifactId>
</exclusion>
</exclusions>
</dependency>
```
同
时，添加servlet-api依赖（provided作用域，表示由容器提供）：
```xml
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<scope>provided</scope>
</dependency>
```
### 2. 修改启动类
每个微服务模块的启动类需要继承`SpringBootServletInitializer`，并重写`configure`方法：
```java
@SpringBootApplication
public class YourApplication extends SpringBootServletInitializer {
@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
return application.sources(YourApplication.class);
}
public static void main(String[] args) {
SpringApplication.run(YourApplication.class, args);
}
}
```
### 3. 打
包
在
项目根
目录下，使用Maven命令打
包：
```bash
mvn clean package
```
打
包后，每个模块的target
目录下会生成对应的
WAR文件。
### 4.
部署到
CentOS 7的
Tomcat
- 将生成的
WAR文件复制到
Tomcat的webapps
目录下（例如：/usr/local/
tomcat/webapps）。
- 启动
Tomcat（如果
Tomcat正在
运行，则复制
WAR文件后会自动解压
部署）：
```bash
cd /usr/local/
tomcat/bin
./startup.sh
```
### 5. 注意事项
- 确保
CentOS 7上已
安装Java环境，并且
Tomcat版本与
项目要求的Java版本兼容。
- 如果微服务之间有依赖（如注册中心、配置中心），确保这些服务已经启动。
- 根据实际情况配置每个微服务的配置文件（如application.yml），特别是数据库连接、服务注册中心地址等，这些配置需要指向正确的环境。
### 6. 前端
部署
根据引用[2]，前端部分需要单独
部署。进入前端
项目（如ruoyi-ui），使用npm构建生产环境代码，然后将生成的dist
目录下的文件
部署到Nginx或
Tomcat中。
```bash
cd ruoyi-ui
npm run build:prod
```
然后将dist
目录下的文件
部署到Web服务器。
### 引用说明
在
部署过程中，参考了若依
项目的
部署文档（引用[2]
和[3]）以及Jenkins
部署的相关内容（引用[4]）。但请注意，ruoyi-cloud的
部署可能还需要考虑服务注册中心（如Nacos）的
部署和配置，因为微服务
项目通常需要服务发现
和配置管理。
[^1]:
部署collector
和web的步骤参考。
[^2]: Ruoyi前端
部署步骤。
[^3]: 若依
项目地址
和MYSQL
安装。
[^4]: Jenkins
安装和部署。
§§相关问题§§
1. 如何将Spring Boot应用打
包为
WAR文件？
2. 在外部
Tomcat中
部署Spring Boot应用需要注意哪些问题？
3. Ruoyi-cloud微服务
项目在
部署时，服务注册中心（如Nacos）应该如何
部署和配置？
4. 如何配置Ruoyi-cloud的数据库连接信息？
5. 如何在前端
部署时配置后端API的代理？</think>### 将 Ruoyi-Cloud 模块打
包为
WAR 文件并
部署到
Tomcat 的步骤
#### 一、修改
项目配置（关键步骤）
1. **修改 pom.xml**
- 在需要
部署的模块（如 `ruoyi-auth`、`ruoyi-gateway` 等）的 `pom.xml` 中：
```xml
<!-- 修改打
包方式 -->
<packaging>
war</packaging>
<!-- 排除内嵌
Tomcat -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-
tomcat</artifactId>
</exclusion>
</exclusions>
</dependency>
<!-- 添加 Servlet 依赖 -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<scope>provided</scope>
</dependency>
```
2. **修改启动类**
```java
@SpringBootApplication
public class RuoyiApplication extends SpringBootServletInitializer { // 继承 SpringBootServletInitializer
@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
return builder.sources(RuoyiApplication.class);
}
public static void main(String[] args) {
SpringApplication.run(RuoyiApplication.class, args);
}
}
```
#### 二、打
包 WAR 文件
1. 在
项目根
目录执行 Maven 命令：
```bash
mvn clean package -DskipTests
```
2. 生成的
WAR 文件位于各模块的 `target/`
目录下，例如：
- `ruoyi-auth/target/ruoyi-auth.
war`
- `ruoyi-gateway/target/ruoyi-gateway.
war`
#### 三、
CentOS 7 部署到
Tomcat
1. **上传
WAR 文件**
```bash
scp ruoyi-*.
war user@
centos_ip:/opt/
tomcat/webapps/
```
2. **重命名为 ROOT.
war（可选但推荐）**
在
Tomcat 的 `webapps/`
目录执行：
```bash
mv ruoyi-gateway.
war ROOT.
war # 主入口模块建议重命名
mv ruoyi-auth.
war auth.
war # 其他模块按需命名
```
> 说明：重命名为 `ROOT.
war` 后可通过 `http://ip:port/` 直接访问，否则需路径后缀（如 `/ruoyi-gateway`）[^1]
3. **启动
Tomcat**
```bash
/opt/
tomcat/bin/startup.sh
```
4. **验证
部署**
- 检查日志：
```bash
tail -f /opt/
tomcat/logs/catalina.out
```
- 访问服务：
```
http://
centos_ip:8080/ # 若命名为 ROOT.
war
http://
centos_ip:8080/auth/ # 其他模块
```
#### 四、配置文件调整
1. **解决端口冲突**
在 `application.yml` 中关闭内嵌服务器：
```yaml
server:
port: -1 # 禁用内嵌端口
```
2. **注册中心配置**
确保 `bootstrap.yml` 中的 Nacos 地址指向正确：
```yaml
spring:
cloud:
nacos:
server-addr: 192.168.1.100:8848 # 修改为实际Nacos地址
```
#### 五、前端
部署（可选）
若需
部署前端：
1. 构建前端：
```bash
cd ruoyi-ui
npm run build:prod # 生成 dist
目录[^2]
```
2. 将 `dist/` 内容
部署到 Nginx 或
Tomcat
> **注意**：
> - 微服务模块需按依赖顺序启动（先启动 Nacos、Auth 等基础服务）
> - 生产环境建议使用 Nginx 反向代理解决端口问题
---
### 常见问题解决
1. **启动报错 `No SpringApplicationContext`**
检查是否遗漏了 `SpringBootServletInitializer` 的继承。
2. **注册中心无法连接**
确认防火墙开放端口（8848/Nacos, 8080/
Tomcat）：
```bash
firewall-cmd --zone=public --add-port=8080/tcp --permanent
firewall-cmd --reload
```
3. **静态资源加载失败**
前端独立
部署时，在 `ruoyi-ui/.env.production` 中配置后端 API 地址：
```
VUE_APP_BASE_API = 'http://
centos_ip:8080/'
```
[^1]:
部署时重命名
WAR 包为 ROOT.
war 可简化访问路径。
[^2]: 前端构建命令参考 Ruoyi 官方文档。
本文探讨了在Tomcat服务器上部署SpringBoot项目时，WAR包及其对应文件夹的操作注意事项。强调了不能在Tomcat运行状态下直接删除WAR包，否则会连同解压后的项目文件夹一并被删除。此外，还讲解了如何正确地更新部署。
扫一扫
1283
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
