最近一个同事开发的新增接口在本地和开发环境的swagger上都能看到,但是在测试环境的swagger上却看不到,并且确定测试环境是最新的代码,并重新构建和部署了。
按照同事的描述,首先我得确定是不是swagger的问题,我先检查我们平台组是否有对swagger做了改造,发现确实做了改造,但都是很久以前的提交记录了,最近并没有改动。
那有什么办法确定到底是不是swagger的问题呢?问题场景是测试环境swagger上没有看到接口信息,那这个接口到底生效没有呢?调用一下不就知道了,所以我调了一下,404了,所以并不是swagger的问题,而是这个接口本身就没有生效。
那这个接口为什么在测试环境不生效,本地和开发环境却生效呢?为了确认到底是不是代码问题,我把测试环境对应分支的代码在本地跑了起来,发现接口和swagger都是生效的,所以测试分支代码是没有问题的。
那是测试环境有问题?可是要排查环境问题更加毫无头绪,而且我们测试环境是K8S集群,问了运维同事,最近也没有做什么改动。
测试分支代码没有问题,测试环境也假设没有问题,那还有哪里可能会有问题呢?
Jar包!代码没有问题,但是打出来的Jar包到底对不对呢?于是我把测试环境的Jar下载下来,解压,找到问题接口所属Controller类的class文件,用IDEA反编译这个类,发现没错啊!是最新的代码啊!有那个接口啊!怎么明明有Controller,有接口,但接口却没有生效啊?
代码没问题,Jar包似乎也没问题,难道真是环境问题?可是环境问题也不太可能只针对某一个接口,其他接口都不受影响呀。
Jar包的静态代码确实没问题,那运行时的代码呢?这是有可能的,比如某个agent正好把这个接口的代码改掉了?带着这个猜想,我用arthas查看这个类,让我发现了一个惊天大秘密!怎么arthas查看到的代码和Jar包里的代码不一样!怎么arthas查到的类中没有那个接口?也就是说应用运行时的Controller类并不是前面看到的Jar包中的类。
明明类名包名都一样,怎么内容不一样?再仔细看看arthas,发现运行时的这个Controller类所属的Jar包是另外一个Jar包!
这里得解释一下我们微服务工程的目录结构,包含一个server模块和一个或多个core模块,现在问题微服务中就有两个core模块,我分别把它们叫做core1和core2。
回到前面的场景,相当于,在代码中,问题接口Controller类是在core1模块的,core2模块没有这个Controller,但是用arthas查看时,却发现这个Controller在core2,这是为什么?
紧接着,我查看Git提交记录,发现这个Controller本来是在core2的,是最近移动到了core1,并新增了这个出现问题的接口,是移动,并不是复制,所以现有的代码中core2是没有这个Controller类的,那为什么arthas查看到这个Controller在core2?
我接着解压测试环境中core2的jar包,发现这个jar包中确实有这个Controller,也就是当前微服务用到的两个core中都有这个Controller,包名类名都一样,但是内容不一样,core2中是旧版本,core1中是新版本,好了,现在问题的表面原因就是core1中新版本Controller没有生效,而旧版本的Controller生效了,这是因为它们两个类名一样,相当于beanName冲突了,所以只有其中一个生效,而此时旧版本胜出了,它生效了,从而导致新增的接口没有生效。
可是为什么明明现在core2的代码中没有这个Controller了,它对应的Jar中却还有呢?
真相呼之欲出,打包出问题了,是不是jenkons拉的分支被人改了?导致拉到的代码不对,导致打出来的包不对?检查jenkins,发现分支是对的,我直接下载解压jenkins页面上的打包结果,发现确实打出来的包是有问题的,那问题到底在哪?
正当没有头绪,盯着Jenkins的流水线配置发呆时,看到了mvn命令,不对劲!!!不对劲!!!,怎么只有install,没有clean参数啊,再对照开发环境,发现开发环境是有clean参数的,所以开发环境没有问题,测试环境没有clean,所以测试环境有问题!!!!!
到此,问题的根本原因找到了,因为打包时没有clean,由于core2只前有这个Controller,所以target目录下还有它编译出来的class文件,尽管后面把代码从core2移到了core1,但是target目录并没有发生变化,又因为没有clean,所以打出来的core2包中还有历史版本的Controller字节码,从而最终运行时覆盖了core1中的新版本Controller,从而导致新接口没有生效,从而导致swagger页面中没有看到新接口!
所以:
在使用maven进行项目打包的时候一定要记得进行一次clean。
在使用maven进行项目打包的时候一定要记得进行一次clean。
在使用maven进行项目打包的时候一定要记得进行一次clean。
还没有评论,来说两句吧...