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

一、问题分析

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

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

# 在 jsp 页面获取 java 类的变量值

    现在因为项目需要,在 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 实现“访问控制”,其原理可以可以参考:

二、问题排查   

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

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

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

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

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

    虽然我修了 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 缓存,我们可以通过执行下面的命令:

rm -rf /path/to/tomcat/work/*

方式2:

    用 RD 命令删除整个目录,只需打开 tomcat/bin/startup.bat 文件,在开头加入:

rd/s/q "/Tomcat path/work/Catalina"

    这样每次启动Tomcat的时候就会先删除页面缓存了,不用担心页面修改后没被重新编译。

四、总结

    如果 JSP 的引用了 java 源代码里的变量。如果该变量的值发生了变化,在重新部署后,记得将Tomcat 下 work 目录里对应的 JSP 文件的缓存进行清理。

你可能感兴趣的:(Tomcat,tomcat,java,servlet)