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

struts.xml 是 Struts2 的核心配置文件吗?
是的,struts.xml 是 Struts2 框架中用于声明式配置 Action、拦截器、结果类型、包结构等的核心 XML 文件。它不是必须命名为 struts.xml,但默认位置和名称被 Struts2 的 XmlConfigurationProvider 自动加载——只要放在 classpath 根路径下(如 src/main/resources/),框架启动时就会读取。
如何在 struts.xml 中定义一个基本 Action?
定义 Action 的关键是用 <action> 元素绑定请求路径与 Java 类,并指定跳转结果。常见错误是类名写错、方法名不存在、或没继承 ActionSupport 却用了 input/success 等预定义结果名。
-
name属性对应 URL 中的 action 名(如/login.action的login) -
class必须是全限定类名(如com.example.LoginAction),且该类需有无参构造函数 -
method可选,默认调用execute();若指定为validateLogin,则会调用同名 public 方法 - 每个
<result>的name需与 Action 方法返回值严格匹配(如return "success";→<result name="success">...)
<?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>
<package name="default" extends="struts-default">
<action name="login" class="com.example.LoginAction" method="execute">
<result name="success">/welcome.jsp</result>
<result name="input">/login.jsp</result>
<result name="error">/error.jsp</result>
</action>
</package>
</struts>
为什么 Action 找不到或 404?常见配置陷阱
多数 404 或 There is no Action mapped for namespace [/] and action name [xxx] 错误,不是代码问题,而是 struts.xml 结构不合规:
- 根
<struts>标签缺失,或 DTD 声明路径过期(Struts 2.5+ 必须用struts-2.5.dtd,旧版 dtd 会导致解析失败静默忽略) -
<package>没有extends="struts-default":这会导致拦截器栈、默认结果类型(如dispatcher)不可用,<result>直接失效 -
name属性含斜杠(如name="/user/login"):URL 路径匹配由 namespace + action name 共同决定,name本身不能带/,应改用namespace="/user" - 多个
<package>同名:Struts2 不允许重名 package,会抛DuplicatePackageException
struts.xml 和注解配置能混用吗?
可以,但需显式启用注解支持,且优先级低于 XML。Struts2 默认只扫描 XML,要让 @Action 生效,必须在 struts.xml 中开启:<constant name="struts.convention.enabled" value="true"/>(注意:这是 Convention 插件机制,不是原生注解)。真正的 @Action 注解依赖 struts2-convention-plugin,且其扫描路径、命名规则(如类名以 Action 结尾)会覆盖 XML 配置——这意味着一旦启用,XML 中同名 action 可能被忽略。
实际项目中,建议二选一:新项目用注解简化配置,遗留系统维护 XML;混合使用极易导致行为不一致,尤其是拦截器链顺序和 result 查找逻辑。










