JSP页面图片不显示，绝大多数情况是图片的URL路径没有正确指向服务器上的实际文件，或者服务器未开放静态资源访问权限。 只要你按“网络请求状态码→路径拼接→部署环境差异”这个顺序排查,基本能在十分钟内定位问题。
jsp图片不显示怎么解决从路径到权限的完整排查
图片加载失败时，浏览器不会直接告诉你“路径错了”，而是给你一个状态码，打开开发者工具（F12），切到Network面板，点击刷新,找到那张红色的图片请求。
先看HTTP状态码，锁定错误类型
- 404 Not Found：服务器上根本找不到这个文件,多为路径写错或文件没放对目录。
- 403 Forbidden：文件存在，但没有权限读取,常见于Linux服务器的文件权限不对。
- 500 Internal Server Error：请求被拦截或服务器处理出错，一般涉及过滤器、Spring拦截器。
一个实用技巧是直接用浏览器地址栏访问图片的完整URL，比如http://localhost:8080/myapp/images/logo.png，看能否单独打开，单独能打开，说明JSP里的路径拼接有问题；单独也打不开,那就是服务器资源摆放问题了。
相对路径是重灾区，contextPath必须前置
很多JSP新手会这样写：
<img src="images/logo.png">如果当前页面是http://localhost:8080/myapp/user/list.jsp，浏览器会把images/logo.png解析成http://localhost:8080/myapp/user/images/logo.png，自然找不到，因为相对路径是相对当前浏览器地址,而不是项目根目录。
行业共识是：在JSP中动态拼上contextPath,即你的项目访问路径。
<img src="${pageContext.request.contextPath}/images/logo.png">这样无论页面在user目录还是admin目录,请求都会回到项目根目录下找图片。
过滤器或拦截器吞掉了图片请求
如果你的项目用了Spring MVC，并且重写了addInterceptors，很可能在拦截路径中没排除静态资源，比如你拦截了，所有images请求都被拦截，而拦截器内部又做了权限校验，直接返回了个异常页面，图片自然就“消失”了。
排查办法：在拦截配置中,放行静态文件。
registry.addInterceptor(loginInterceptor)
.addPathPatterns("/")
.excludePathPatterns("/images/", "/css/", "/js/");如果你用的是Servlet本身的Filter，也需要在web.xml的url-pattern里排除掉.jpg、.png等后缀。
jsp访问服务器图片路径错误怎么办？先学会查看真实部署目录
路径错误不仅仅是“少了个斜杠”，更多的场景是：本地开发环境正常，部署到Tomcat或Jetty后,图片文件根本没在你指定的那个目录里。
分清磁盘路径和虚拟路径
JSP代码里能拿到的request.getServletContext().getRealPath("/")，返回的是服务器磁盘上的绝对路径，比如/usr/local/tomcat/webapps/myapp/，而浏览器访问/myapp/images/logo.png时，Tomcat会自动映射到webapps/myapp/images/logo.png。
如果你把图片上传到了服务器的/data/upload/，那就需要配置一个虚拟映射，让/upload这个URL指到磁盘的/data/upload/，这一步经常被忽略,导致图片上传成功但前端永远看不到。
Tomcat默认目录和项目名冲突
Tomcat的默认根目录是webapps/ROOT，如果你的项目叫myapp，默认情况下http://localhost:8080/会访问ROOT，而不是你的myapp，你必须访问http://localhost:8080/myapp。
所以当你部署后，如果路径里忘了带项目名，或者图片位置放在了webapps/myapp/images/，但URL写成了http://localhost:8080/images/logo.png，那必然404，具体操作：进入tomcat的webapps/myapp目录，用ls -l确认图片文件确实在那里,并且大小不为0。
用c:url标签和fn:join规避拼写失误
如果你觉得${pageContext.request.contextPath}太长，也可以使用JSTL的c:url
<img src="<c:url value='/images/logo.png'/>">c:url会自动把当前项目的contextPath加到前面，还能处理URL编码中的特殊字符,适合批量替换现有页面中的相对路径。
本地正常部署到服务器后图片却消失，这个差异在哪里
很多项目在Windows本地上一切正常，一旦发到Linux服务器，图片就全军覆没，这类问题往往不是代码逻辑,而是环境差异。
严格区分大小写的坑
Windows文件系统不区分大小写，而Linux严格区分，你在本地写了<img src="Images/Logo.PNG">，实际文件名是images/logo.png，本地因为不区分大小写能显示,上传到CentOS或Ubuntu后就404。
业内专家指出，这类问题占比相当大，排查方式很简单：在服务器上执行find /你的项目目录 -name '.png',对比一下实际文件名和JSP里的引用字符串。
文件名编码和中文路径问题
图片文件名含中文或空格时，浏览器会做URL编码，但浏览器和服务器对编码的解析可能不一致，例如中文文件名“商品图片.png”，浏览器请求时会变成%E5%95%86%E5%93%81...，而Tomcat默认的URI编码可能不是UTF-8,就会匹配不到。
稳妥做法分两步：第一步，把文件名统一改成英文小写加下划线，比如product_main.png；第二步，在server.xml中配置URIEncoding="UTF-8",确保Tomcat能正确处理编码后的URL。
反向代理和真实IP透传
如果服务器前面挂了Nginx，图片请求会被Nginx先接收，你需要确认Nginx的location /images/配置是否把请求转发到了Tomcat指定端口，并且proxy_pass后面是否带了正确的URI。
你可以直接在服务器本机执行：
curl -I http://localhost:8080/myapp/images/logo.png如果本机返回200，但通过域名访问404，那就说明Nginx的映射规则有问题，比如缺少location ~ .(jpg|png)$的动静分离配置。
jsp图片显示不出来，用绝对路径还是相对路径更稳妥
这个问题没有绝对答案,但按场景选能省不少事。
页面层级简单的静态网页，相对路径没问题
如果你的JSP页面都放在同一层目录，图片也放在该目录下的images子目录，
webapp/index.jspwebapp/images/pic.png
那src="images/pic.png"完全够用,浏览器能正确解析。
多层级目录或伪URL下，绝对路径是唯一解
当页面出现在/user/center/profile.jsp，图片在/images/pic.png时，如果你用相对路径，就得写../../images/pic.png
，一旦目录结构调整，立刻失效，此时用${pageContext.request.contextPath}/images/pic.png最稳,因为它永远从项目根开始。
外部CDN或文件服务器，直接用完整URL
如果你的图片不是放在Web应用的webapps目录，而是单独的文件服务器，比如https://static.example.com/upload/pic.png，那JSP里直接写完整URL即可，不需要拼接contextPath，这种场景下，JSP只是充当了一个HTML模板,图片加载完全由浏览器和CDN服务器交互。
| 场景 | 推荐路径写法 | 原因 |
|---|---|---|
| 单层页面小应用 | 相对路径images/pic.png |
简单直观 |
| 多模块项目 | ${pageContext.request.contextPath} |
防止目录层级漂移 |
| 前后端分离 | 完整CDN URL | 减轻应用服务器压力 |
关于jsp访问服务器图片不显示的三个常见问答
为什么图片在IDEA里能显示，打包成war部署到云服务器后就不行了？
先看war包解压后的目录结构，用unzip -l target/myapp.war | grep img检查图片是否被打进了包里，很多构建工具配置不当，会把images目录排除掉，确认后，把图片放到src/main/webapp/images/下，再重新构建，同时确认云服务器的安全组开放了对应的8080端口，用curl http://你的公网IP:8080/myapp/images/logo.png -v进行测试。
Spring Security会拦截图片吗？
会，Spring Security默认会对所有请求做认证，如果没配置permitAll，图片请求会被重定向到登录页，在SecurityConfig里执行.antMatchers("/images/").permitAll()即可,这是多数情况下的直接解法。
图片路径正确，但浏览器缓存一直显示旧图怎么办？
这不是“不显示”，而是缓存了旧响应，在JSP图片URL后面加时间戳，比如<img src="${contextPath}/images/logo.png?version=${systemTime}">，或者在Nginx配置中给图片静态资源设置expires 1d;，保证缓存过期后重新加载，最终以服务器返回的Last-Modified或ETag头为准,浏览器会根据这些字段决定是否重发请求。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/702503.html
