Struts2.3.32升级到Struts2.5.26详细步骤(无敌版)

2022-01-30 00:00:00 步骤 升级到 无敌

Struts2真是三天两头爆出漏洞来,特别是一爆出漏洞就建议升级到最新版,也是无语的,并且最新版相比老板还相差挺大的,这部这次需要从Struts2.3.32一下子就必须升级到最新版,这可让人头大,谷歌百度了几天都没有解决方案,大概是因为每个人的项目都是不同的吧,有些用纯注解,有些用配置文件,所以可能适合你的解决方案却不适合别人,最终还是得靠自己解决,下面整理了一下我的解决方案,其中有些错误只能通过修改源码来搞定的。

###一、项目背景
这里先要说一下要升级的项目背景,因为不同架构的项目升级方法可能有差异,我用的项目是Struts2.3.32,然后用纯注解动态方法调用的模式,也就是直接在Action上面加上请求的注解,然后每个方法都是请求路径,不需要修改配置文件,格式如下:

@ParentPackage(value = "default")
@Namespace(value = "/")
@Action(value = "indexAction",results = {
        @Result(name = "test",location = "/test.jsp"),
        @Result(name = "test2",location = "/test2.jsp")
})
public class IndexAction{
    public String test(){
        System.out.println("我是action,被test1调用");
        return "test";
    }
    public String test2(){
        System.out.println("我是action,被test2调用");
        return "test2";
    }
}

后面如果想要加请求也很简单,直接多加一个方法,然后多加一个@Result返回值就可以了。这个是我的项目结构,下面的升级步骤也是基于这个结构来的,不过就算大家的结构有区别,那么也应该有借鉴的地方,反正我基于的逻辑就是,实在是解决不了就从源码下手。

###二、环境准备
我觉得,升级之前的第一步就是自己用最新版的Struts2搭建一个项目,保证自己的升级包是可以用的先,然后在对比自己项目的区别逐个攻破,所以我先自己搭建了一个例子:Strtus2.5.26动态方法调用注解模式环境搭建:https://www.suibibk.com/topic/788791049202958336

这里需要去官网下载struts2.5.26的环境包和源码包:http://struts.apache.org/download.cgi#struts2526

struts-2.5.26-all.zip (65MB) [PGP] [SHA256]
struts-2.5.26-src.zip (7MB) [PGP] [SHA256]

我本地搭建的时候貌似tomcat需要为tomcat8,但是在我的项目上貌似用apache-tomcat-7.0.96也可以,不过jdk好像就需要1.8,不然会报各种各样的错误,得看每个人的具体情况。

###三、Struts2.3.32升级到Struts2.5.26步骤
####1、修改web.xml
在2.5.26后,struts的过滤器也改了一下,少了ng的包路径

<filter>
	<filter-name>struts2</filter-name>
	<filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter</filter-class>
</filter>

####2、修改struts.xml
struts.xml的配置文件也需要修改下,比如主动开启动态方法调用,然后加上全局方法允许访问的配置,如下:

<constant name="struts.enable.DynamicMethodInvocation" value="true"/>
<constant name="struts.enable.SlashesInActionNames" value="true"/>
<constant name="struts.action.extension" value="do" />
<package name="default" extends="struts-default">
    ...
    <global-allowed-methods>regex:.*</global-allowed-methods>
</package>

然后配置文件头部的版本也要改为2.5

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.5//EN"
    "http://struts.apache.org/dtds/struts-2.5.dtd">

注意事项:
注1:这里的package中的name一定要跟你Action中的@ParentPackage注解对应的一样
我注2:我看网上还有些需要加上:strict-method-invocation=“false”,我升级发现并不需要

####3、整理需要的jar包
这里导入的jar包应该是你自己搭建测试的里面的jar包,也就是从struts-2.5.26\apps\struts2-showcase\WEB-INF\lib获取jar包,但是还要做如下处理

  • 把spring开头的删除
  • 把tiles开头的删除

####4、删除原来的多余的jar包
删除你原来项目中在你新准备的jar包中已经存在的版本不同的jar包,也就是替换老的jar包,我这里就直接根据前缀来删除了,不过删除之前必须先备份,因为可能会多删除,那么需要把相应的jar包还原:

rm -rf struts*
rm -rf asm*
rm -rf commons*
rm -rf velocity*
rm -rf log*
rm -rf antlr*
rm -rf dom4j-1.6.1.jar
rm -rf dwr.jar 
rm -rf freemarker-2.3.22.jar
rm -rf xwork-core-2.3.32.jar

其实在后面的启动阶段就会报如下错误:

报错1:Caused by: java.lang.NoClassDefFoundError: Lorg/apache/log4j/Logger;
是因为新的log4j-api-2.12.1.jar包没有这个包路径,所以要把上面log4j-1.2.13.jar还原回去

报错2:找不到commons下面的http包
所以要把commons-httpclient-3.0.jar还原回去

当然每个人的老项目都可能不一样,所以不一定会遇到这两个错误。

####5、上传jar包
把你在第3步骤整理的jar包上传。

####6、启动项目
在启动之前,需要先准备一下,准备测试链接,我这里要做这一步是因为我们这个项目只有一个开发环境,所以不能影响正常开发,我就再nginx做了一个路径拦截,拦截某一路径然后转发到我这个应用下面。

如果启动报某些类找不到,那么应该是上面自己多删了,还原回去多删的就好,如果还有找不到的,就网上找到放进去就好,这些都不是问题,遇到的最最最棘手,最最最让人崩溃的问题是下面这个问题:

convention.annotation.Result.name()(Found data of type calss java.lang.String[index])

这个怎么搞,看了下@Result的源码,果然发现在以前的版本name是一个字符串,现在这个新的版本name是一个字符串数组,我的天,也就是说需要在注解上用如下模式?

@Result(name = {"test"},location = "/test.jsp"),

我看网上有一个人的解决方案就是把把项目中所有的name=”xxx”改为name={“xxx”},这当然可以解决,但是注解其实就算你要求的是:

String[] name;

你还是可用name=”xxx”的模式的,所以这个原因我们应该可以排除。然后网上说重新编译一下项目就好了,那当然,其实上面的改为{“xxxx”}的模式的方法应该也是重新编译一下项目就好了,但是我们的项目是在是太老了,重新编译不了,并且有些类跟生产环境的对不上,如果每个文件都要重新登记下版本重新取一下编译好的字节码class换到生产环境,可能性不大,并且我们的老项目本地丢启动不了,有些还有报错,所以这种解决方案我这边也用不了。

后面我想,得先看看现在的name解析的是什么,然后我就拷贝了一份struts2.5.26的源码,找到使用这个注解的地方,其实也就是在如下类中:

org/apache/struts2/convention/DefaultResultMapBuilder#createFromAnnotations

按相同的路径新建这个类然后修改下源码,打印出来:

for (Result result : results) {
    System.out.println("result:"+result);
    for (String name : result.name()) {
         ResultConfig config = createResultConfig(actionClass, new ResultInfo(
                name, result, packageConfig, resultPath, actionClass,
                resultsByExtension), packageConfig, result);
        if (config != null) {
            resultConfigs.put(config.getName(), config);
        }
}

将编译后的文件放入项目的class目录下,重新启动,发现打印出的日志如下:

@org.apache.struts2.convention.annotation.Result(name=sun.reflect.annotation.AnnotationTypeMismatchExceptionProxy@46e93c84, location=/chinapost/weixin/activitys/posterSharing/index.jsp, type=, params=[])

很明显name既不是字符串也不是数组,是一个异常对象:

sun.reflect.annotation.AnnotationTypeMismatchExceptionProxy@46e93c84,

百度了下该异常:AnnotationTypeMismatchException异常。

public class AnnotationTypeMismatchExceptionextends RuntimeException若某个注释的类型在对该注释进行编译(或序列化)后发生了更改,而程序试图访问该注释的元素时,抛出此异常。

那应该是我们之前的源码编译是基于name为字符串的,现在直接不重新编译,替换jar包后,新的注解Result和DefaultResultMapBuilder类不能对之前的编译的类进行处理了,然后就报错了,那也解释了为什么网上的解决方案都是重新编译就可以了,那我既然不能重新编译怎么办呢,解决方案如下:重写Result和DefaultResultMapBuilder。

####7、重写Result和DefaultResultMapBuilder
重写org.apache.struts2.convention.annotation.Result注解和org.apache.struts2.convention.DefaultResultMapBuilder

Result将String[] name 改为String name

DefaultResultMapBuilder的方法createFromAnnotations for循环改为直接取

for (Result result : results) {
        	System.out.println("result:"+result);
        	String name = result.name();
          //  for (String name : result.name()) {
                ResultConfig config = createResultConfig(actionClass, new ResultInfo(
                        name, result, packageConfig, resultPath, actionClass,
                        resultsByExtension), packageConfig, result);
                if (config != null) {
                    resultConfigs.put(config.getName(), config);
                }
          //  }
        }

然后项目可以启动了,打印出来的Result的name也是一个字符串啦。也就相当于有如下两个解决方案

**解决方案1:**重新编译项目即可
**解决方案2:**不能重新编译项目则重写Result和DefaultResultMapBuilder,兼容以前的模式。

注:目前不清楚改了这两个地方是否有太大影响,但是知道的是name不能用数组的模式,必须按以前的单个值的模式开发。

####8、访问测试
访问发现报如下错误

Exception occurred during processing request: javax.servlet.ServletException: java.lang.NoSuchMethodError: org.apache.struts2.views.jsp.PropertyTag.setEscape(Z)Vorg.apache.jasper.JasperException: javax.servlet.ServletException: java.lang.NoSuchMethodError: org.apache.struts2.views.jsp.PropertyTag.setEscape(Z)V

这个是jsp报错,因为最新版本有一些标签页变了,这个要相应的改一下:
如果你有这样的代码

<s:url id="url" action="login">
<s:set id="str1" value="'string1 value'" />
<s:iterator value="tradeList" id="trade" status="status"> 
<s:set name="myCode" value=" *** "/>
<s:property escape="true" var="someProperty"/>

需要改成:

<s:url var="url" action="login">
<s:set var="str1" value="'string1 value'" />
<s:iterator value="tradeList" var="trade" status="status">
<s:set var="myCode" value=" *** "/>
<s:property escapeHtml="true" var="someProperty"/>

然后再访问就成功进入啦。

###四、总结
####1、升级步骤

  • 修改web.xml,将过滤器改为最新版本
  • 修改struts.xml 主动开启动态方法调用
  • 替换最新版本的jar包
  • 若可以重新编译项目,则直接重新编译项目
  • 若不可重新编译项目,则修改对应源码做兼容处理这里修改的额源码为:Result和DefaultResultMapBuilder
  • 修改JSP相应标签

####2、遗留问题

  • 需要对所有jsp进行检查看看是否需要改标签
  • 还未对是否兼容spring做检查,因为我们这个项目是直接调用微服务来处理的,不过也用了spring,还需要继续测试看看是否会有问题
  • 源码的修改为验证是否对其他功能有影响,唯一知道的是@Result中name不能用数组name{“xxxx”}模式,必须按以前的字符串模式name=“xxxx”
  • 待续…

###五、问题更新
####1、若Action没有加上@ParentPackage(value=“default”)会报404(20201221)
这个是因为若是没有加上这个注解,那么会去取默认的值,默认的值是没有加上下面这一段配置的

 <global-allowed-methods>regex:.*</global-allowed-methods>

解决方案如下:

**方案1:**在每一个Action上面加入上面的注解:@ParentPackage(value=“default”)即可
该方案对于老项目来说可能需要改动的类较多。并且换搬到生产需要换很久都不换的类,风险较高。

**方案2:**把struts2-core-2.5.26.jar里面的struts-default.xml文件取出来编辑在package下入上面的配置即可,
也就相当于我们再默认的struts-default上面也加入。改方案风险叫小但是后续有struts2升级可能会直接替换,忘记需要先修改jar包里面的配置文件。

**方案3:**在web.xml中指定配置文件的路径,然后加载我们指定的struts-default.xml,如下

<filter>
    <filter-name>struts2</filter-name>
    <filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter</filter-class>
	<init-param>
		<param-name>config</param-name>
		<param-value>config/struts-default.xml,struts-plugin.xml,struts.xml</param-value>
	</init-param>
</filter>

然后我们就可以在src目录下新建一个config文件夹,将修改好的struts-default.xml放进去即可(对应服务器上class目录下新建一个config文件夹),struts-default.xml的
改动其实就只是加如下内容而已:

注意:这里struts-default.xml必须在config或者别的文件夹下面,因为这个是有改过的,不然会跟jar包里面的冲突。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-YFhStvTm-1608801867149)(/fileupload/images/202012/1608533632983.png)]

方案1、2、3目的都是让<global-allowed-methods>regex:.*</global-allowed-methods>配置生效。大家可以根据自己项目的情况选择方案。

来源我的博客:个人随笔-二、Struts2.3.32升级到Struts2.5.26详细步骤(无敌版)

    原文作者:爱吃鱼的乌贼
    原文地址: https://blog.csdn.net/weixin_41271981/article/details/111642705
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。

相关文章