使用HttpServletResponse sendRedirect跳转后CSS失效问题排查

这种本地运行正常、部署到服务器就加载不了CSS的问题，我在日常开发中碰到过好多次，基本都是路径、配置或者权限类的问题，给你梳理几个最典型的情况：

• 相对路径不匹配上下文根
  本地直接打开HTML文件时，./customStyle.css是基于当前文件所在目录的相对路径，但部署到服务器后，你的应用通常会有一个上下文根（Context Root）（比如http://your-server/your-app/）。如果HTML里还是用相对路径引用CSS，浏览器会把它解析为http://your-server/customStyle.css，而实际文件在http://your-server/your-app/customStyle.css，自然会404。
  解决办法：

  • 改用基于应用根的绝对路径，比如在HTML里写：<link rel="stylesheet" href="/your-app/customStyle.css">
  • 如果是Java Web项目，也可以用EL表达式动态获取上下文路径：<link rel="stylesheet" href="${pageContext.request.contextPath}/customStyle.css">

• 服务器静态资源映射未配置
  有些服务器（比如Tomcat、Jetty）需要明确配置静态资源的访问规则，否则会拒绝访问CSS、JS这类文件。

  • 传统Web项目：要确保web.xml里配置了正确的<mime-mapping>，让服务器识别CSS类型：

    <mime-mapping>
        <extension>css</extension>
        <mime-type>text/css</mime-type>
    </mime-mapping>
    

  • Spring Boot项目：检查application.properties里是否配置了静态资源路径：

    spring.mvc.static-path-pattern=/static/**
    spring.web.resources.static-locations=classpath:/static/
    

    确保你的CSS文件放在src/main/resources/static目录下。

• 服务器文件权限不足
  部署到Linux/Unix服务器时，很容易遇到文件权限问题：服务器进程（比如Tomcat的运行用户）没有读取CSS文件的权限。
  解决办法：

  • 修改文件权限为可读：chmod 644 customStyle.css
  • 把文件所有者改成服务器运行用户：chown tomcat:tomcat customStyle.css（假设服务器用户是tomcat）

• 重定向路径解析错误
  你用response.sendRedirect()时，如果用的是相对路径，服务器可能会根据当前请求的路径来解析，导致HTML文件的位置不对，连带CSS加载失败。
  比如在http://your-server/your-app/api/redirect这个接口里重定向到./page.html，服务器会解析成http://your-server/your-app/api/page.html，但如果你的HTML文件在your-app根目录下，就会找不到。
  解决办法：用绝对路径进行重定向，结合上下文根：

  response.sendRedirect(request.getContextPath() + "/page.html");
  

• 缓存导致的旧路径残留
  有时候浏览器或者服务器的缓存会保留旧的CSS路径，即使你已经修正了路径，浏览器还是会请求旧的地址。
  解决办法：

  • 清空浏览器缓存（快捷键Ctrl+Shift+Delete）
  • 在CSS文件名后加版本号，强制浏览器加载新文件：<link rel="stylesheet" href="customStyle.css?v=1.0.1">

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