【问题标题】:Building a deployable WAR based on a spring-boot project基于 spring-boot 项目构建可部署的 WAR
【发布时间】:2026-01-14 22:55:02
【问题描述】:

我正在尝试从 Spring-boot 项目创建一个 WAR 文件,它允许用户使用 java -jar filename 运行该文件并使用 tomcat 部署该文件。

现在,我有这样的配置:

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.springframework</groupId>
    <artifactId>springapp</artifactId>
    <version>1.0.0</version>
    <packaging>war</packaging>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.2.6.RELEASE</version>
    </parent>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
            <scope>provided</scope>
        </dependency>
    </dependencies>

    <properties>
        <java.version>1.7</java.version>
    </properties>


    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

Application.java

package org.hello;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.context.web.SpringBootServletInitializer;
import org.springframework.boot.builder.SpringApplicationBuilder;

@SpringBootApplication
public class Application extends SpringBootServletInitializer {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(Application.class);
    }

}

HelloController.java

package org.hello;

import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.RequestMapping;

@RestController
public class HelloController {

    @RequestMapping("/")
    public String index() {
        return "Greetings from Spring Boot!";
    }

}

使用此配置,我可以在命令行中使用java -jar filename 运行应用程序,但是当我在tomcat 中部署war 时,访问/ 页面时出现404 错误页面。 (应用部署时不显示错误)。

我在这里缺少什么?

【问题讨论】:

  • 当应用部署到 Tomcat 时,您用来访问应用的完整 URL 是什么?war 文件的名称是什么?
  • 完整的url是http://server:8080/springapp-1.0.0,war文件是springapp-1.0.0.war
  • 你说没有错误显示。还显示什么?您应该会在 Tomcat 的日志中看到输出,显示正在部署的战争以及您的应用程序正在启动——Spring Boot 的横幅等。
  • 在文件/var/log/tomcat6/catalina.out部署后唯一显示的行是:Oct 15, 2015 11:38:34 AM org.apache.catalina.startup.HostConfig deployWAR // INFO: Deploying web application archive springapp-1.0.0.war

标签: spring tomcat spring-boot


【解决方案1】:

默认情况下,Spring Boot 要求您的容器支持 Servlet 3.0 或更高版本。 Tomcat 6 仅支持 Servlet 2.5。最简单的选择是升级到 Tomcat 7 或 8。

如果您无法升级到 Tomcat 7 或 8,那么您的应用程序仍然可以运行。但是,这将需要更多的努力。作为described in the documentation,需要添加对org.springframework.boot:spring-boot-legacy的依赖,并添加一个web.xml,内容如下:

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>demo.Application</param-value>
    </context-param>

    <listener>
        <listener-class>org.springframework.boot.legacy.context.web.SpringBootContextLoaderListener</listener-class>
    </listener>

    <filter>
        <filter-name>metricFilter</filter-name>
        <filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
    </filter>

    <filter-mapping>
        <filter-name>metricFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <servlet>
        <servlet-name>appServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextAttribute</param-name>
            <param-value>org.springframework.web.context.WebApplicationContext.ROOT</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>appServlet</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

</web-app>

【讨论】:

  • 我应该把这个 web.xml 文件放在我的项目树的什么地方?也许 /src/main/resources?