struts.xml是什么如何用它来配置Struts2的Action

月夜之吻 2026-01-25 00:00:00 次阅读

是的，struts.xml 是 Struts2 的核心配置文件，用于声明式配置 Action、拦截器、结果类型和包结构，默认位于 classpath 根路径下并由 XmlConfigurationProvider 自动加载。

struts.xml 是 Struts2 的核心配置文件吗？

是的，struts.xml 是 Struts2 框架中用于声明式配置 Action、拦截器、结果类型、包结构等的核心 XML 文件。它不是必须命名为 struts.xml，但默认位置和名称被 Struts2 的 XmlConfigurationProvider 自动加载——只要放在 classpath 根路径下（如 src/mai

n/resources/），框架启动时就会读取。

如何在 struts.xml 中定义一个基本 Action？

定义 Action 的关键是用元素绑定请求路径与 Java 类，并指定跳转结果。常见错误是类名写错、方法名不存在、或没继承 ActionSupport 却用了 input/success 等预定义结果名。

name 属性对应 URL 中的 action 名（如 /login.action 的 login）
class 必须是全限定类名（如 com.example.LoginAction），且该类需有无参构造函数
method 可选，默认调用 execute()；若指定为 validateLogin，则会调用同名 public 方法
每个的 name 需与 Action 方法返回值严格匹配（如 return "success"; → ...）





  
    
      /welcome.jsp
      /login.jsp
      /error.jsp

为什么 Action 找不到或 404？常见配置陷阱

多数 404 或 There is no Action mapped for namespace [/] and action name [xxx] 错误，不是代码问题，而是 struts.xml 结构不合规：

根标签缺失，或 DTD 声明路径过期（Struts 2.5+ 必须用 struts-2.5.dtd，旧版 dtd 会导致解析失败静默忽略）
没有 extends="struts-default"：这会导致拦截器栈、默认结果类型（如 dispatcher）不可用，直接失效
name 属性含斜杠（如 name="/user/login"）：URL 路径匹配由 namespace + action name 共同决定，name 本身不能带 /，应改用 namespace="/user"
多个同名：Struts2 不允许重名 package，会抛 DuplicatePackageException

struts.xml 和注解配置能混用吗？

可以，但需显式启用注解支持，且优先级低于 XML。Struts2 默认只扫描 XML，要让 @Action 生效，必须在 struts.xml 中开启：（注意：这是 Convention 插件机制，不是原生注解）。真正的 @Action 注解依赖 struts2-convention-plugin，且其扫描路径、命名规则（如类名以 Action 结尾）会覆盖 XML 配置——这意味着一旦启用，XML 中同名 action 可能被忽略。

实际项目中，建议二选一：新项目用注解简化配置，遗留系统维护 XML；混合使用极易导致行为不一致，尤其是拦截器链顺序和 result 查找逻辑。