IDEA 2024.3 导入 SSM 项目 404 排查5 步定位 Tomcat 部署路径与模块配置当你在 IDEA 2024.3 中导入一个传统的 SSM 项目时可能会遇到控制台没有报错但访问页面却返回 404 的情况。这种问题通常与项目结构、模块配置或 Tomcat 部署路径有关。本文将带你通过 5 个关键步骤系统排查问题。1. 检查项目结构与模块配置首先需要确认 IDEA 是否正确识别了你的项目结构。SSM 项目通常包含以下关键目录src/main/java- Java 源代码src/main/resources- 配置文件WebContent或webapp- Web 资源在 IDEA 中右键项目 - Open Module Settings检查以下配置Facets配置确保已添加 Web FacetWeb Resource Directories 应指向你的 Web 根目录如WebContentArtifacts配置确认已创建 Web Application: Exploded 类型的 ArtifactOutput Directory 应指向正确的输出路径提示如果是从 Eclipse 导入的项目可能需要手动调整目录结构标记。右键目录 - Mark Directory as - 选择相应类型如 Sources Root、Resources Root 等2. 验证 Tomcat 部署配置Tomcat 的部署配置是 404 错误的常见原因。检查以下设置打开 Run/Debug Configurations选择你的 Tomcat 配置检查 Deployment 标签页确保已添加正确的 ArtifactApplication context 应与你的预期访问路径一致例如/your-project对应访问路径http://localhost:8080/your-project常见错误配置对比错误配置正确配置未指定 Artifact添加 Web Application: ExplodedApplication context 为空设置为/your-project部署路径指向错误目录指向包含 WEB-INF 的目录3. 检查模块依赖与类路径SSM 项目依赖众多确保所有必要依赖已正确配置检查pom.xmlMaven 项目或项目依赖!-- 必要依赖示例 -- dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.3.23/version /dependency在 Project Structure - Modules - Dependencies 中确认所有依赖已正确解析检查是否有红色标记的缺失依赖对于非 Maven 项目确保WEB-INF/lib目录包含所有必要 JAR 文件4. 验证 Spring 配置与组件扫描即使项目结构正确Spring 配置问题也会导致 404检查web.xmlservlet servlet-namedispatcher/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-value/WEB-INF/spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet确认spring-mvc.xml中的组件扫描配置context:component-scan base-packagecom.your.package/检查控制器注解Controller RequestMapping(/example) public class ExampleController { GetMapping(/test) public String test() { return test-page; // 对应视图名称 } }5. 排查路径映射与视图解析最后一步检查请求路径与视图解析视图解析器配置示例bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/views// property namesuffix value.jsp/ /bean访问路径构成应用上下文路径/your-project来自 Tomcat 配置控制器路径/example来自RequestMapping方法路径/test来自GetMapping完整访问路径http://localhost:8080/your-project/example/test常见 JSP 路径问题确保 JSP 文件位于WEB-INF/views/根据视图解析器配置检查 JSP 文件权限和名称大小写Linux 系统区分大小写通过这 5 个步骤的系统检查你应该能够定位并解决 SSM 项目在 IDEA 中的 404 问题。如果仍然遇到问题可以查看 Tomcat 日志获取更详细的错误信息通常位于logs/catalina.out或 IDEA 的运行控制台中。