Tomcat Artifact为空问题排查求助（Java Spring项目）

API 探路者

2026-5-13

排查Tomcat启动后应用"空"状态的方案

先从你重建Artifact这个核心操作入手，一步步排查可能的问题：

验证Artifact的输出结构：打开Project Structure > Artifacts，选中你创建的Web Application: Exploded，查看右侧的Output Layout。重点确认：
- web模块的WEB-INF/classes是否包含自身编译后的class文件
- WEB-INF/lib里有没有core模块的jar包（或者core的class文件是否被合并到WEB-INF/classes中）
  如果core模块的产物完全没出现在Artifact里，web依赖的服务根本加载不到，自然不会初始化Spring上下文。
确认Deployment Descriptor路径：检查WEB-INF/web.xml（或者Spring Boot项目的ServletInitializer类）是否被正确标记为Deployment Descriptor。如果这个关键配置文件缺失或路径错误，Tomcat只会启动一个空容器，不会识别这是Java Web应用。

确认Artifact已添加到部署列表：打开Run/Debug Configurations，选中你的Tomcat实例，切换到Deployment标签。确保你新建的Artifact已经被添加，并且Application context设置符合你的预期（比如/或者自定义的路径）。如果没添加Artifact，Tomcat启动后就是空的，没有部署任何应用。
调整日志输出级别：Hibernate日志没显示可能是日志级别太高。在IDEA的Run窗口右上角点击Edit Log Levels，把org.hibernate的级别设为DEBUG或INFO；或者检查项目的logback.xml/log4j2.xml配置，确保相关日志包的输出级别正确。

检查组件扫描范围：如果你用注解驱动的Spring，确保web模块的@SpringBootApplication（或@Configuration + @ComponentScan）的扫描路径包含core模块的包。比如core模块的包是com.example.core，web的配置类需要加上：
```
@SpringBootApplication(scanBasePackages = {"com.example.web", "com.example.core"})
```
否则core模块的Bean、REST接口、Hibernate配置都不会被加载。
查看Tomcat的详细错误日志：IDEA的Run窗口可能只显示部分日志，去Tomcat的本地日志目录（一般在IDEA项目根目录/.idea/tomcat/[你的Tomcat实例名]/logs下）查看localhost.log和localhost.xxxx-xx-xx.log，有没有ClassNotFoundException、NoSuchBeanDefinitionException这类错误——这些通常是依赖缺失或扫描范围不对导致的。

重新执行Gradle构建：手动创建Artifact后，Gradle的编译产物可能没同步到Artifact的输出目录。在IDEA右侧的Gradle面板，执行web模块的clean和build任务，完成后再重新部署Tomcat。
检查web模块的war插件配置：确保web模块的build.gradle里war插件配置正确，比如有没有正确引入core模块依赖：
```
plugins {
    id 'war'
    id 'org.springframework.boot' version '2.7.0'
    id 'io.spring.dependency-management' version '1.0.11.RELEASE'
}

dependencies {
    implementation project(':core')
    // 其他必要依赖...
}
```
如果war插件没正确打包core模块的依赖，部署后应用会缺少关键类。

如果以上步骤都没解决问题，可以补充以下信息方便进一步排查：

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