基于Spring框架的JSP中复选框勾选时自定义图片不显示问题

嘿，我之前在项目里也踩过一模一样的坑——本地测试功能正常，一集成到JSP里自定义图片就失踪了！咱们从几个最常见的原因入手排查：

• 图片路径绝对是头号嫌疑人
  JSP里的资源路径是相对于Web应用根目录的，不是你本地的文件路径哦！比如你之前可能写了src="C:/images/check.png"这种本地绝对路径，或者src="../images/check.png"这种相对当前页面的路径，一旦JSP放在项目子目录下就会失效。
  正确的做法是用JSP内置对象获取应用根路径：

  <img id="customCheckImg" style="display:none;" src="${pageContext.request.contextPath}/images/check.png" />
  

  记得把图片放在Web项目的webapp/images/目录下（或者你自定义的静态资源目录），这样服务器才能正确访问到。

• 静态资源被框架拦截了
  如果你的项目用了Spring MVC、Struts这类框架，DispatcherServlet可能会拦截所有请求，包括图片这类静态资源。这时候得在配置里放行静态资源：
  比如Spring MVC可以在spring-servlet.xml里加：

  <mvc:resources mapping="/images/**" location="/images/" />
  

  或者在web.xml里让默认Servlet处理静态资源：

  <servlet-mapping>
      <servlet-name>default</servlet-name>
      <url-pattern>*.png</url-pattern>
  </servlet-mapping>
  

• 浏览器缓存在搞鬼
  有时候浏览器会缓存旧的资源，哪怕你已经换了新图片，它还是显示原来的（或者直接显示找不到）。试试按Ctrl+F5强制刷新页面，或者给图片URL加个版本号参数来绕过缓存：

  src="${pageContext.request.contextPath}/images/check.png?v=1.0"
  

• 文件权限或服务器读取问题
  检查一下图片文件的权限：Linux下要确保文件权限是644，目录是755，让Tomcat有读取权限；Windows下别把文件设成只读。另外，确认图片文件名没有拼写错误（Linux服务器是区分大小写的，这点很容易忽略！）。

• JS动态修改路径的坑
  如果是用JavaScript动态控制图片显示/隐藏，那JS里的路径也要用应用根路径，不能用相对路径。比如：

  // 错误写法：相对当前页面，JSP在子目录时会失效
  // document.getElementById('customCheckImg').src = '../images/check.png';
  
  // 正确写法：用JSP生成的根路径
  document.getElementById('customCheckImg').src = '${pageContext.request.contextPath}/images/check.png';
  

先从路径问题开始排查吧，这是最常见的原因！祝你顺利解决~

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