SpringBoot Docker 静态资源404问题解析

在使用SpringBoot与Docker进行开发时，我们可能会遇到静态资源404的问题。本文将通过代码示例和序列图、旅行图来分析问题原因，并提供解决方案。

问题描述

在SpringBoot项目中，我们通常会将静态资源放在/static、/public或/resources等目录下。但是，当我们将SpringBoot应用打包成Docker镜像并运行时，可能会发现访问这些静态资源时出现404错误。

原因分析

  1. Dockerfile配置问题：Dockerfile中可能没有正确复制静态资源目录。
  2. SpringBoot配置问题：SpringBoot可能没有正确配置静态资源的访问路径。

解决方案

Dockerfile配置

首先，我们需要确保Dockerfile正确复制了静态资源目录。以下是一个简单的Dockerfile示例：

FROM openjdk:8-jdk-alpine
VOLUME /tmp
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} app.jar
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]

确保将静态资源目录复制到Docker镜像中。

SpringBoot配置

接下来，我们需要在SpringBoot中配置静态资源的访问路径。以下是一个简单的配置示例：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.servlet.ServletComponentScan;
import org.springframework.boot.web.servlet.ServletRegistrationBean;
import org.springframework.context.annotation.Bean;

import javax.servlet.ServletContext;
import javax.servlet.ServletException;

@SpringBootApplication
@ServletComponentScan
public class Application {

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

    @Bean
    public ServletRegistrationBean servletRegistrationBean() {
        ServletRegistrationBean servlet = new ServletRegistrationBean(new Servlet() {
            @Override
            public void init(ServletConfig config) throws ServletException {
            }

            @Override
            public ServletConfig getServletConfig() {
                return null;
            }

            @Override
            public void service(ServletRequest req, ServletResponse res) throws ServletException, IOException {
                String path = req.getServletPath();
                if (path.startsWith("/static")) {
                    path = path.substring(7);
                    req.getRequestDispatcher("/" + path).forward(req, res);
                }
            }

            @Override
            public String getServletInfo() {
                return null;
            }

            @Override
            public void destroy() {
            }
        }, "/static/*");

        servlet.setLoadOnStartup(1);
        return servlet;
    }
}

这段代码通过自定义Servlet来拦截对/static目录的请求，并将其转发到正确的路径。

序列图

以下是SpringBoot处理静态资源请求的序列图：

sequenceDiagram
    participant User as U
    participant Browser as B
    participant SpringBoot as S
    participant Docker as D

    U->>B: Request static resource
    B->>S: Forward request
    S->>D: Serve static resource
    D-->>S: Resource not found
    S-->>B: 404 error

旅行图

以下是用户访问静态资源的旅行图：

journey
    title Accessing Static Resources
    section User's Request
      U: Request static resource
    section Browser's Action
      B: Forward request to SpringBoot
    section SpringBoot's Handling
      S: Intercept request and forward to Docker
    section Docker's Response
      D: Resource not found
    section Error Handling
      S: Return 404 error to Browser

结语

通过上述分析和解决方案，我们可以解决SpringBoot Docker静态资源404的问题。关键在于正确配置Dockerfile和SpringBoot的静态资源访问路径。希望本文对您有所帮助。