[Java知识库]Java项目Struts2.3.35升级到2.5.30过程中遇到的问题

项目需要，要把原本的struts做升级，遇到页面样式失效的问题，特此记录查寻结果和修改方法

官方参考的struts2.5升级时使用的jar包

commons-fileupload-1.3.3.jar
commons-io-2.5.jar
freemarker-2.3.23.jar
javassist-3.20.0-GA.jar
log4j-api-2.8.2.jar
ognl-3.1.15.jar
struts2-core-2.5.13.jar

1、Struts2找不到org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter
参考：https://blog.csdn.net/hgx_suiyuesusu/article/details/78167616
引用包需要从org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter
更改为org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter
2、ClassNotFoundException: org.apache.logging.log4j.Logger
引入相应log的jar包即可
可参考：https://blog.csdn.net/weixin_42756361/article/details/102502842
https://bbs.csdn.net/topics/392182439

在maven中引入新的log4j包

<dependency>
	<groupId>org.apache.logging.log4j</groupId>
	<artifactId>log4j-api</artifactId>
	<version>2.11.0</version>
</dependency>
<dependency>
	<groupId>org.apache.logging.log4j</groupId>
	<artifactId>log4j-core</artifactId>
	<version>2.11.0</version>
</dependency>

如果不是maven的项目就将jar包下载下来放在项目的lib目中并引入?

3、org.apache.struts2.convention.DefaultClassFinder - Unable to read class
可参考：https://blog.csdn.net/qq_16711967/article/details/79345906

使用SSH框架但是报错不能读取，根据报错明显是struts2-convention插件创建导致了不兼容问题，项目中不需要它，所以删除该插件，然后编译运行没有运行错误。

4、java.lang.NoSuchMethodError:org.apache.commons.lang3.reflect.MethodUtils.getAnnotation
https://blog.csdn.net/qq_44790703/article/details/108078498

5、Struts?jsp标签问题，有两个错误。
5.1、org.apache.jasper.JasperException: /main/synccontent/retransquery/manage_list.jsp(24,5) Attribute id invalid for tag bean according to TLD
这个问题，是jar包升级后，原有的标签写法不能用了，这也是Struts的一个缺点，版本升级居然不做向下兼容，导致我这边的jsp用的低版本标签，全部作废，第一想法就是，修改jsp页面了，这工作量太大了，不现实。于是，想到了自定义标签的办法，来解决这个兼容问题

首先在web.xml里配置关联自定义标签的文件

<jsp-config>
	<taglib>
		<taglib-uri>/struts-tags</taglib-uri>
		<taglib-location>/WEB-INF/struts-tags.tld</taglib-location>
	</taglib>
</jsp-config>

然后，编写struts-tags.tld文件，内容如下，可以复制直接使用，添加tag和attribute标签

<?xml version="1.0" encoding="UTF-8"?>
<taglib xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.0" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd">
	<description><![CDATA["To make it easier to access dynamic data;
		the Apache Struts framework includes a library of custom tags.
		The tags interact with the framework's validation and internationalization features;
		to ensure that input is correct and output is localized.
		The Struts Tags can be used with JSP FreeMarker or Velocity."
	]]></description>
	<display-name>"Struts Tags"</display-name>
	<tlib-version>2.2.3</tlib-version>
	<short-name>s</short-name>
	<uri>/struts-tags</uri>
<tag>
		<description><![CDATA[Print out expression which evaluates against the stack]]></description>
		<name>property</name>
		<tag-class>org.apache.struts2.views.jsp.PropertyTag</tag-class>
		<body-content>empty</body-content>
		<attribute>
			<description><![CDATA[The default value to be used if <u>value</u> attribute is null]]></description>
			<name>default</name>
			<required>false</required>
			<rtexprvalue>false</rtexprvalue>
		</attribute>
		<attribute>
			<description><![CDATA[ Whether to escape HTML]]></description>
			<name>escape</name>
			<required>false</required>
			<rtexprvalue>false</rtexprvalue>
		</attribute>
		<attribute>
			<description><![CDATA[Whether to escape Javascript]]></description>
			<name>escapeJavaScript</name>
			<required>false</required>
			<rtexprvalue>false</rtexprvalue>
		</attribute>
		<attribute>
			<description><![CDATA[Value to be displayed]]></description>
			<name>value</name>
			<required>false</required>
			<rtexprvalue>false</rtexprvalue>
		</attribute>
		<dynamic-attributes>false</dynamic-attributes>
	</tag>
</taglib>

这样配置好后，就可以解决上述问题

5.2、javax.servlet.ServletException: /main/synccontent/retransquery/manage_list.jsp(129,21) Unable to find setter method for attribute: escape
这个问题是基于5.1解决之后，产生的问题，attribute 配置问题。我这边升级的jar版本是
struts2-core-2.5.26.jar。但是，自定义标签配置中，escape attribute 对应的java类，没有set方法，导致的这个错误。
我们查看struts-tags.tld配置文件，发现，对应的class是

<tag-class>org.apache.struts2.views.jsp.PropertyTag</tag-class>

可以看出，它是Struts jar包中的类。
全局搜索出这个PropertyTag.class文件，会发现，里面确实没有escape对应的set方法
于是，修补jar包，加上set方法即可

6、tag ‘select’, field ‘list’, name ‘contentType’: The requested list key ‘#syscodeBean.syscodeBysernoList’ could not be resolved as a collection/array/map/enumeration/iterator type. Example: people or people.{name} - [unknown location]
访问jsp页面总是报这个错误

排查过程：
首先看错误日志，找到这个错误片段，但是，还是很难定位原因
然后，启动本地项目，访问同一个jsp页面，居然是好的，看来是项目代码管理乱了
再叫运维拉服务器代码，到本地查看比对两个页面的差异
发现，不一样的地方是

服务器代码：
<s:bean name="com.linkage.system.components.system.ui.pagebean.SyscodeBean" id="syscodeBean">
本地代码：
<s:bean name="com.linkage.system.components.system.ui.pagebean.SyscodeBean" var="syscodeBean">

遇到的不仅<s:bean>标签<s:iterator>标签等中的id换成var

会发现，是id和var变量的问题
这里就涉及到Struts2的自定义标签的知识点
按住ctrl，点击id，进入tld配置文件，找到class
org.apache.struts2.views.jsp.BeanTag
直觉判断，是Struts2的标签里把变量名定义成var，所以，用id时候无法识别
于是，debug，发现

org.apache.struts2.views.jsp.BeanTag中

    protected void populateParams() {
        super.populateParams();
        ((Bean)this.component).setName(this.name);
    }

发现，用id的时候，component里面对应的变量var是null
查看ContextBeanTag.super.populateParams();
发现，这里定义了变量名是var，于是，确定了根源在这个class文件的不兼容问题上
在找到低版本的jar，查看同名文件，发现低版本的里面

public void setId(String id) {
    this.setVar(id);
}

通过这个方法，吧id值传给了var变量，从而做到了兼容效果，解决了该问题

7、升级对struts.xml的修改

<?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">
<struts>
	<constant name="struts.multipart.maxSize" value="1073741824" />
	<constant name="struts.custom.i18n.resources" value="applicationResource_en" />
	<constant name="struts.i18n.encoding" value="UTF-8" />
	<constant name="struts.multipart.saveDir" value="/ticm/temp" />
	<constant name="struts.objectFactory" value="spring" />
	<constant name="struts.enable.DynamicMethodInvocation" value="true"/>
	<constant name="struts.action.extension" value="do" />

	<!-- 让jsp拥有html同样的样式，防止变形 -->
	<constant name="struts.ui.theme" value="simple" />
	<constant name="struts.ui.templateDir" value="template" />
	<constant name="struts.ui.templateSuffix" value="ftl" />

	<package name="abstract_struts" abstract="true" extends="struts-default"
		namespace="/">
		<result-types>
			<result-type name="json" class="org.apache.struts2.json.JSONResult" />
		</result-types>
		<!-- check login interceptor -->
		<interceptors>
			<interceptor name="checkLoginInterceptor" class="checkLoginStack" />
			<interceptor-stack name="checkLoginStack">
				<interceptor-ref name="checkLoginInterceptor" />
				<interceptor-ref name="defaultStack" />
			</interceptor-stack>
		</interceptors>
		<default-interceptor-ref name="checkLoginStack" />
		<global-results>
			<result name="loginAciton" type="redirect">/loginPage.do</result>
			<result name="loginPage">/system/login/login.jsp</result>
			<result name="error">/pages/common/errors/error.jsp</result>
			<result name="exception">
				/pages/common/errors/exception.jsp
			</result>
		</global-results>
		<global-allowed-methods>regex:.*</global-allowed-methods>
	</package>

	<include file="struts/struts-import-basic.xml" />
	<include file="struts/struts-import-prom.xml" />
</struts>

遇到问题时多排查日志发现问题