首次用Tomcat部署Tapestry Maven项目遇HTTP 404：仅部署META-INF与WEB-INF

我之前也踩过几乎一模一样的Tapestry+Tomcat部署坑！先帮你梳理下问题根源：你提到Tomcat只部署了META-INF和WEB-INF，这大概率是你的war包本身就不完整——毕竟Tomcat只是解压部署war包，不会主动删减文件。下面是一步步排查和修复的方法：

第一步：先确认war包本身是否完整 #

直接用压缩软件打开你生成的.war文件，检查除了META-INF和WEB-INF之外，是否有Tapestry需要的入口文件（比如框架自动生成的index相关资源），或者你自定义的静态文件。如果war包本身就只有这两个目录，那问题出在Maven打包环节，和Tomcat无关。

第二步：修复Maven打包的问题 #

Tapestry是组件化框架，它的页面模板、静态资源需要通过Maven插件正确打包到war里，常见的打包问题有两个：

• Tapestry Maven插件配置缺失：检查你的pom.xml，确保已经引入了Tapestry的Maven插件，并且配置了打包执行目标：

  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.tapestry</groupId>
        <artifactId>tapestry-maven-plugin</artifactId>
        <version>${tapestry.version}</version>
        <executions>
          <execution>
            <id>package</id>
            <goals>
              <goal>package</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
  

  没有这个插件的话，Tapestry的组件资源不会被正确打包到war里。
• 自定义资源未被纳入打包：如果你的项目里有自己的css、js、图片等静态资源，需要在pom.xml里配置resources节点，确保这些文件被复制到war包的正确位置：

  <build>
    <resources>
      <resource>
        <directory>src/main/resources</directory>
        <includes>
          <include>**/*</include>
        </includes>
      </resource>
    </resources>
  </build>
  

第三步：检查Tomcat的部署配置 #

如果war包没问题，那再排查Tomcat的部署环节：

• 部署方式是否正确：如果你是把war包丢到webapps目录下，Tomcat会自动解压部署，但要注意war包的文件名会作为应用的上下文路径（比如myapp.war对应的访问路径是http://localhost:8080/myapp）。如果上下文路径不对，也会出现404。
• 权限问题：Tomcat运行用户如果没有webapps目录或者war包的读写权限，可能会导致部分文件无法解压。检查一下目录和文件的权限，给Tomcat用户加上读写权限。
• Context配置是否正确：如果你在conf/server.xml里手动配置了Context节点，确保docBase和path参数都正确：

  <Context docBase="myapp.war" path="/myapp" reloadable="true"/>
  

最后：验证修复结果 #

重新执行mvn clean package生成新的war包，解压确认所有必要文件都存在后，再放到Tomcat里部署启动。访问对应的上下文路径，应该就能正常打开应用了。

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