struts.xml 是 struts2 的核心配置文件,须置于 web-inf/classes(或 maven 的 src/main/resources),含标准 dtd 声明和 根元素;通过 配置开发模式、自动重载等; 需继承 struts-default 并设 namespace; 绑定类与方法, 定义跳转视图;支持 拆分模块。

struts.xml 是 Struts2 框架的中枢配置文件,它不负责业务逻辑,但决定了请求怎么进、Action 怎么跑、结果往哪跳。配置对了,整个 MVC 流程才通;配错了,404、500、空指针可能全来报到。
基础结构和文档声明
struts.xml 必须放在 WEB-INF/classes 目录下(Maven 项目放 src/main/resources 即可),且开头需带标准 DTD 声明,否则框架加载失败:
<?xml version="1.0" encoding="UTF-8"?>- 根元素必须是
<struts></struts>,所有配置都嵌套其中
全局常量配置(<constant></constant>)
用 <constant></constant> 覆盖默认行为,开发阶段建议启用以下几项:
-
<constant name="struts.devMode" value="true"></constant>:开启开发模式,错误堆栈更友好,支持热重载 -
<constant name="struts.configuration.xml.reload" value="true"></constant>:修改 struts.xml 后自动重新加载,免重启 -
<constant name="struts.i18n.encoding" value="UTF-8"></constant>:统一请求与响应编码,防中文乱码 -
<constant name="struts.action.extension" value="action"></constant>:限定只有*.action请求交由 Struts2 处理(配合 web.xml 中 filter 的url-pattern)
包(<package></package>)组织与继承
每个 <package></package> 是独立的功能模块单元,必须满足:
-
name 属性必填,且全局唯一,如
name="user"或name="admin" -
必须 extends="struts-default"(或插件提供的包如
json-default),否则拦截器链、类型转换等核心功能失效 -
namespace 推荐以 / 开头,如
namespace="/user",它与 action 的 name 共同构成访问路径:/user/login.action - 可设
abstract="true"定义抽象包,仅用于被继承,不能定义 action
Action 与结果视图(<action></action> 和 <result></result>)
Action 是请求入口,result 是响应出口,二者绑定在 package 内:
-
<action name="login" class="com.example.LoginAction" method="execute"></action>:name 对应 URL 尾部(不含 .action),class 默认为 ActionSupport,method 可省略 -
<result name="success">/WEB-INF/jsp/welcome.jsp</result>:name 默认是 success,对应 Action 方法返回值;路径支持绝对(/xxx)或相对(同 package 下) - 支持全局 result:在 package 内定义
<global-results><result name="error">/error.jsp</result></global-results>,所有该包内 Action 都可直接返回"error"
模块拆分与复用(<include></include>)
大型项目推荐按业务拆分配置文件,避免 struts.xml 膨胀难维护:
- 新建
user.xml、order.xml等,各自含完整<struts><package>...</package></struts> - 主 struts.xml 中用
<include file="user.xml"></include>引入,顺序即加载顺序(父 package 必须先于子 package 被引入) - 注意:每个被 include 的文件也需有独立的 DTD 声明和
<struts></struts>根节点










