使用了struts标签的jsp页面使用时报异常：The Struts dispatcher cannot be found.

原创于 2020-02-22 13:36:32 发布 · 517 阅读

0 ·

本内容遵循CC 4.0 BY-SA版权协议

收录于

JSP

本文介绍了一种在使用Struts2框架时遇到的常见问题，即在header.jsp中使用Struts标签导致的异常，并提供了详细的解决方案。问题源于未正确配置Struts过滤器，文章指导如何在web.xml中添加必要的过滤器配置，以及如何确保项目中包含正确的struts2-core依赖。

问题描述：

在header.jsp中，存在使用了struts标签的如下代码：

                 <s:if test="#session.userName == '' || #session.userName == null" >
					 <div class="user_login">
					  	 <a href="user/website/login.do" >
	                		[登录]
	              		</a>
						<strong>|</strong>
			         </div> 
					 <div class="user_register">
					  	 <a href="user/website/userRegister.do" >
	                		[注册]
	              		</a>
			         </div>
		         </s:if><s:else>
		         	 <div class="user_login">
		         	 	 <span>欢迎您：<s:property value="#session.userName"/></span>
						 <strong>|</strong>
			         </div> 
					 <div class="user_register">
					  	 <a href="javascript:void(0);" οnclick="logout();" >
	                		[退出]
	              		</a>
			         </div>
		         </s:else>

在这个header.jsp中已经引用了struts-tags

但是，在项目启动后访问到这个页面的时候报异常，如下：

The Struts dispatcher cannot be found. This is usually caused by using Struts tags without the associated filter. Struts tags are only usable when the request has passed through its servlet filter, which initializes the Struts dispatcher needed for this tag. - [unknown location]

问题分析：

从提示信息中得知：在jsp文件中使用了struts标签，但是在项目中并没有配置struts标签相关的过滤器filter。因此，需要到项目的web.xml中添加这个过滤器filter。

解决方案：

<filter>
    <filter-name>struts2</filter-name>
    <filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter</filter-class>
  </filter>
  <filter-mapping>
    <filter-name>struts2</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>

此外，要注意添加org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter相关的jar包，或者若是Maven项目则需要在pom.xml中配置相关的dependency。

<dependency>
		 <groupId>org.apache.struts</groupId>
		 <artifactId>struts2-core</artifactId>
		 <version>2.5.22</version>
</dependency>

在这个依赖包struts2-core-2.5.22.jar中找到了StrutsPrepareAndExecuteFilter.calss，如下图所示。