NetBeans中Spring 4.0.1应用CSS/JS文件放置与访问问题排查

嘿，我之前在Spring MVC + GlassFish的环境里也踩过静态资源访问的坑，结合你描述的项目结构（Web-INF和resources同级在Web根目录下），给你几个针对性的排查和解决步骤，应该能帮你搞定：

1. 先确认Spring MVC的静态资源配置是否正确 #

Spring默认会拦截所有请求，所以必须明确配置让它放行静态资源的访问：

• XML配置方式：在你的Spring MVC配置文件（比如spring-servlet.xml）里添加以下代码：

  <!-- 放行静态资源 -->
  <mvc:resources mapping="/resources/**" location="/resources/" />
  <!-- 启用Spring MVC注解驱动，这步很关键，否则静态资源配置可能不生效 -->
  <mvc:annotation-driven />
  

  注意location的值是/resources/，因为你的resources目录和Web-INF同级，直接在Web根目录下，末尾的斜杠不要漏。

• Java注解配置方式：如果你的项目用Java类做配置，要在Web配置类里重写addResourceHandlers方法：

  @Configuration
  @EnableWebMvc // 必须加这个注解，启用MVC核心配置
  public class WebAppConfig implements WebMvcConfigurer {
      @Override
      public void addResourceHandlers(ResourceHandlerRegistry registry) {
          // 映射URL路径到实际资源目录
          registry.addResourceHandler("/resources/**")
                  .addResourceLocations("/resources/");
      }
  }
  

2. 页面里的资源引用路径必须正确 #

绝对不要用相对路径（比如../resources/css/style.css），推荐用上下文路径拼接的方式，避免部署路径变化导致的问题：

<!-- 引用CSS文件 -->
<link rel="stylesheet" href="${pageContext.request.contextPath}/resources/css/style.css" />
<!-- 引用JS文件 -->
<script src="${pageContext.request.contextPath}/resources/js/main.js"></script>

这里${pageContext.request.contextPath}会自动获取项目的上下文根路径，确保资源路径在任何部署环境下都正确。

3. 检查NetBeans的打包配置，确保resources目录被正确打包 #

右键你的项目 → 选择清理并构建，然后去项目的dist目录找到生成的war包，解压后看看根目录里有没有resources文件夹，以及里面的CSS/JS文件是否完整。如果没有的话：

• 右键项目 → 属性 → 切换到源标签页
• 确认resources目录被添加到源包/文件夹列表里，如果没有，点击添加文件夹把它加进去。

4. 排查拦截器/过滤器是否拦截了静态资源 #

如果你自定义了拦截器或者过滤器，一定要确保它们不会拦截/resources/**路径的请求：

• 拦截器配置（XML方式）：

  <mvc:interceptors>
      <mvc:interceptor>
          <mvc:mapping path="/**"/>
          <!-- 排除静态资源路径 -->
          <mvc:exclude-mapping path="/resources/**"/>
          <bean class="com.yourpackage.YourCustomInterceptor"/>
      </mvc:interceptor>
  </mvc:interceptors>
  

• 过滤器配置（web.xml）：确保<url-pattern>不要覆盖静态资源路径，或者添加排除规则（部分过滤器支持）。

5. 清理缓存，排除缓存干扰 #

有时候浏览器或服务器缓存会导致资源加载异常：

• 浏览器端：按Ctrl+Shift+R强制刷新页面，清除浏览器缓存
• GlassFish服务器：停止服务器，删除GlassFish安装目录/domains/domain1/generated和domains/domain1/cache目录，然后重启服务器再部署项目。

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