共享出行管理系统-问题解决-3-平芜编程栈

问题(部署工件时出错)：

配置错误: 部署源 'shared-mobility:war' 无效[2025-12-01 08:08:10,138] 工件 shared-mobility:war: 部署工件时出错。请参阅服务器日志了解详细信息。 01-Dec-2025 20:08:19.893 信息 [Catalina-utility-2] org.apache.catalina.startup.HostConfig.deployDirectory 把web 应用程序部署到目录 [C:\apache-tomcat-10.1.34\webapps\manager] 01-Dec-2025 20:08:20.882 信息 [Catalina-utility-2] org.apache.catalina.startup.HostConfig.deployDirectory Web应用程序目录[C:\apache-tomcat-10.1.34\webapps\manager]的部署已在[988]毫秒内完成

遇到的「部署源 'shared-mobility:war' 无效」+ Tomcat 仅部署了manager目录的问题，核心是Maven 打包/IDEA 部署配置错误，导致 Tomcat 无法识别shared-mobility.war包，以下是分维度解析和修复方案：

解决：

一、核心原因拆解

错误类型	具体原因
部署源无效	IDEA 中配置的「部署工件」路径错误（找不到`shared-mobility.war`），或 WAR 包未生成
Tomcat 仅部署 manager	Tomcat 自动扫描`webapps`目录时，未发现`shared-mobility.war`/解压后的文件夹，仅部署了自带的`manager`应用
隐性问题	Maven 打包时未生成 WAR 包，或 WAR 包生成路径与 IDEA 部署配置不匹配

二、分步修复（从基础到进阶）

步骤1：先确认 Maven 已生成有效的 WAR 包

这是所有部署的前提，先手动打包验证：

打开终端，进入后端项目根目录（shared-mobility-backend）；
执行 Maven 打包命令：
```
mvn clean package -DskipTests
```
- 成功：终端显示BUILD SUCCESS，且target目录下生成shared-mobility.war文件；
- 失败：先解决编译错误（如代码语法、依赖缺失），确保 WAR 包生成。

步骤2：修复 IDEA 部署配置（核心）

若 WAR 包已生成，但 IDEA 提示「部署源无效」，是 IDEA 的「运行/调试配置」错误：

打开 IDEA → 右上角「Edit Configurations...」（运行配置）；
找到 Tomcat 10 配置 → 切换到「Deployment」标签页；
移除无效的「部署源」（shared-mobility:war）；
点击「+」→ 选择「Artifact」→ 选择shared-mobility:war exploded（优先选解压版，部署更快）；
- 若没有exploded选项：先执行mvn clean compile war:exploded生成解压后的目录；
确认「Application context」为/shared-mobility（与 WAR 包名一致）；
点击「Apply」→「OK」保存配置。

步骤3：手动部署 WAR 包（兜底方案，绕过 IDEA 配置）

若 IDEA 配置仍有问题，直接手动将 WAR 包部署到 Tomcat，验证包本身是否有效：

停止 Tomcat（关闭startup.bat，或 IDEA 中停止 Tomcat 服务）；
将target/shared-mobility.war复制到 Tomcat 的webapps目录（C:\apache-tomcat-10.1.34\webapps）；
启动 Tomcat（执行startup.bat）；
查看 Tomcat 日志：
- 成功：日志显示Deploying web application archive [C:\apache-tomcat-10.1.34\webapps\shared-mobility.war]，且webapps目录下生成shared-mobility解压文件夹；
- 失败：日志会显示具体错误（如 WAR 包损坏、依赖缺失），针对性解决。

步骤4：排查 WAR 包无效的隐性原因

若手动部署仍失败，大概率是 WAR 包本身有问题：

检查 WAR 包兼容性： Tomcat 10.1 仅支持jakarta.servlet.*包（而非javax.servlet.*），确认项目中无javax.servlet依赖（你的pom.xml已用jakarta.servlet-api，这一步可跳过）；
检查 WAR 包内容：解压shared-mobility.war，确认WEB-INF/classes下有编译后的 Servlet 类（如LoginServlet.class），且WEB-INF/lib下有依赖包（如gson-2.10.1.jar）；
- 若classes为空：执行mvn clean compile重新编译代码，再打包；
检查 Tomcat 端口/权限：
- 确保 8080 端口未被占用（占用会导致 Tomcat 启动异常，无法部署应用）；
- 确保 Tomcat 目录有读写权限（Windows 下右键 Tomcat 目录 → 「属性」→ 取消「只读」）。

三、关键验证步骤

启动 Tomcat 后，访问http://localhost:8080/manager/html（Tomcat 管理后台）；
输入 Tomcat 用户名/密码（需在conf/tomcat-users.xml中配置权限）：
```
<user username="admin" password="admin" roles="manager-gui,admin-gui"/>
```
在「Deploy」区域查看已部署的应用，若能看到shared-mobility（路径/shared-mobility），说明部署成功；
访问后端接口：http://localhost:8080/shared-mobility/api/login，应能正常响应（非404）。

四、常见避坑点

IDEA 未关联 Maven 项目：右键项目 →「Add Framework Support...」→ 勾选「Maven」，确保 IDEA 识别 Maven 配置；
Tomcat 配置未指向正确目录： IDEA 中 Tomcat 配置的「Tomcat Home」需指向C:\apache-tomcat-10.1.34，而非其他版本；
打包时跳过了 web.xml 检查：你的pom.xml中maven-war-plugin已配置<failOnMissingWebXml>false</failOnMissingWebXml>，无需额外处理。