Java Web中解决Struts2捕获404错误的问题

Struts2与原生404处理的差异

在常规的Java Web应用中，我们通常会在web.xml中通过配置全局错误页来捕获所有未找到的资源。然而，Struts2作为一个强大的MVC框架，会对特定的URL模式（如.action后缀）进行拦截和处理。

登录及主界面效果：

如果访问者在浏览器地址栏输入随机字符或标点符号，原生环境通常能顺利跳转到自定义的404页面：

但如果输入的URL带有.action后缀，例如：/randomTest.action，且该Action未在框架中配置时：

此时，原本预期跳转的通用404处理机制会失效。由于URL符合Struts2的拦截规则，系统会尝试寻找对应的Action类。当找不到时，便会触发Struts2内部的异常处理逻辑，而不是Tomcat等容器的HTTP 404响应。

前端报错信息示例：

后端控制台日志输出：

解决404捕获问题的方法

为了优雅地处理这类由“不存在Action”引发的类似404的情况，我们可以采用以下几种策略进行配置。

方法一：结合web.xml全局错误页（局限性说明）

虽然可以通过以下代码将标准的HTTP 404码重定向到自制页面：

<error-page>
  <error-code>404</error-code>
  <location>/404.html</location>
</error-page>

但需要注意，如前所述，这种方式在处理.action后缀的无效请求时往往无能为力，因为这些请求被Struts2截获后并未产生标准的容器级404响应。

方法二：使用struts.xml中的default-action-ref（推荐方案）

最彻底的解决办法是利用Struts2提供的默认动作引用功能。通过配置default-action-ref，当用户请求一个不存在的Action时，框架会自动转而执行指定的“默认Action”，从而实现页面的可控跳转。

步骤如下：

1. 定义接收请求的目标页面：准备一个友好的404错误展示页面（如404.html或专门的Error Action）。
2. 配置struts.xml：在XML配置文件中添加以下代码块：

<!-- 声明默认动作引用 -->
<default-action-ref name="pageNotFound" />

<!-- 定义默认动作的具体逻辑 -->
<action name="pageNotFound">
  <result>/404.html</result>
</action>

原理解析：

• pageNotFound是我们自定义的一个占位Action名称。
• 当请求匹配不到任何已注册的Action时，Struts2会自动查找default-action-ref指向的名称。
• 执行该Action的结果页面被硬编码为/404.html。
• 这种方式不仅能处理.action的请求，也能在一定程度上涵盖其他形式的未定义路由请求。

总结

对于面向生产环境的Web应用来说，让用户看到充满技术术语的框架报错是非常不友好的体验。通过利用Struts2的default-action-ref特性，我们可以将所有非法或未定义的Action请求平滑地引导至预置的友好提示页面。这不仅弥补了原生HTTP状态码在特定框架下的覆盖盲区，也提升了整体系统的健壮性与用户体验。

以上就是Java Struts2中有效捕获并处理404错误页面的详细内容，更多关于Java Web开发与异常处理的相关资料请关注本站其它相关文章！