Tomcat 的 work 目录缓存导致的JSP页面图片更新问题

news2024/9/21 22:35:08

一、问题分析

1. 修改后重新部署没有变化

笔者之前部署了一个后台管理项目，通过它来发布课程内容，其中有一个 JSP 课程页面，在该 JSP 页面里也引用了类文件 Constant.java 里的一个变量（ALIYUN_OSS_PATH），该变量的值是一个域名地址（static.aaa.com），在该 JSP 页面基于这个地址来加载和显示图片（static.aaa.com/x.png）。

# 在 jsp 页面获取 java 类的变量值
<c:set var="aliyun" value="<%=com.xxx.admin.common.Constants.ALIYUN_OSS_PATH%>"/>

现在因为项目需要，在 Constant.java 文件里更改了这个该变量的值：

//修改前
//public static final String ALIYUN_OSS_PATH = "http://static.aaa.com/";
//修改后
public static final String ALIYUN_OSS_PATH = "http://static.bbb.com/";

然后重新部署，但是却发现所有的图片都打不开了。但是在浏览器展示的页面上拷贝图片地址，发现与和之前的图片地址没有任何变化：static.aaa.com/x.png，本来希望出现的变化是：static.bbb.com/x.png

总之一句话，就是项目修改并重新部署后 JSP 页面的图片路径没有更新。

2. 图片无法正常显示分析

原先浏览器入口路径是 admin.aaa.com, 图片请求地址是：static.aaa.com/x.png ；

现在浏览器入口路径是 admin.bbb.com, 图片请求地址仍然是：static.aaa.com/x.png, 并没有变成我希望的修改后的 static.bbb.com.

这里图片为什么之前能打开？现在重新部署后，路径没有变化为什么反而打不开呢？这个与部署后，进入网站后台入口地址发生了变化有关系：

浏览器是通过 admin.aaa.com 进入后台管理，发起请求时，http 头的 referer url 路径就是入口路径：admin.aaa.com，这与 OSS 服务端设置的 referrer url 白名单一致，所以能正常打开图片。现在更新部署后，请求的图片路径没有变化，仍然是 static.aaa.com/x.png，但是管理后台的入口地址变更为： admin.bbb.com , 所以 header 头里带的 referer url 路径就变成 admin.bbb.com. 这个与 OSS 服务端设置的 refer url 白名单不一致，所以导致图片无法正常请求。

通过 referer url 实现“访问控制”，其原理可以可以参考: <HTML页面跨域请求图片资源报错>

二、问题排查

一开始是怀疑浏览器的缓存导致，重新清理了浏览器的缓存重启浏览器，再次打开后台页面，仍然没有任何改变。

问题进一步排除，继续去查看项目部署后台的文件，发现有更新的 java源文件，在编译后的 class 文件确实已经更新完毕。为什么 jsp 页面图片就是无法正常打开了。

排除了以上问题后，开始怀疑在【服务端的Tomcat是否有类似浏览器一样的缓存】，经过查询后，定位到了 Tomcat 下的 WORK 目录。原来所有的 JSP 页面都会编译成 _jsp.java 和 _jsp.class 文件，存储在这个目录下，如果 jsp 发生了改变，tomcat 会重新编译，在前端请求时候将重新编译后的 _jsp.class 文件载入内存：

现在问题明白了。因为我的 JSP 文件引用 java 类文件了的 oss 路径变量：

<c:set var="aliyun" value="<%=com.xxx.admin.common.Constants.ALIYUN_OSS_PATH%>"/>

虽然我修了 java 源代文件里的 ALIYUN_OSS_PATH 变量的值后重新部署，但是 work 目录下的 JSP 文件本身没有进行任何修改，所以在重新部署后，JSP 不会重新编译，在发起请求时，tomcat 仍然调用的是之前缓存的 _jsp.class 文件，该文件里面 ALIYUN_OSS_PATH 值并没更新。所以图片加载地址就没有变化，仍然是之前的：static.aaa.com/x.png, 而不是更新后的 static.bbb.com/x.png

三、问题解决

方式1：

清理 Tomcat 缓存，我们可以通过执行下面的命令：