struts.xml 是 Struts2 应用的中枢配置文件，以标准 XML 声明和匹配版本的 DTD 开头，根元素为 ；常量配置须在 外， 用于逻辑分组并支持继承， 映射请求与处理类， 定义视图跳转，支持 拆分模块。
struts.xml 是 Struts2 应用的中枢配置文件，它决定了请求如何映射到 Action、结果如何渲染、拦截器如何介入，以及模块如何组织。结构清晰、配置得当，是项目稳定和可维护的关键。
根元素与 DTD 声明
文件必须以标准 XML 声明开头，并严格匹配对应 Struts 版本的 DTD（文档类型定义），否则解析失败：
- —— 必须存在，且编码建议统一为 UTF-8
- —— DTD 声明需与所用 Struts 版本一致（如 2.5 对应 struts-2.5.dtd）；若离线开发，可将 dtd 文件下载后本地引用
- 根元素固定为
，所有配置都嵌套其中
常量配置（）
用于覆盖 Struts 默认行为，常见于开发调试或环境适配：
- struts.devMode = true：开启开发模式，修改配置或资源文件后无需重启容器（注意：生产环境务必设为 false）
- struts.configuration.xml.reload = true：配合 devMode，使 struts.xml 修改后自动重载
- struts.action.extension = action,do：指定可触发 Action 的 URL 后缀，多个用逗号分隔
- struts.i18n.encoding = utf-8：统一请求参数和响应的字符编码，避免中文乱码
- 所有
必须放在 外部，且优先于 package 定义生效
包配置（）
package 是 struts.xml 的核心组织单元，类似 Java 包，用于逻辑分组和继承复用：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- name 属性必须唯一，不可重复，是该包的标识符
- extends="struts-default" 推荐始终继承，否则无法使用拦截器、result 类型等核心功能
- namespace 决定 URL 路径前缀，如 namespace="/user" → 请求地址为 /user/login.action；空字符串 "" 或 "/" 表示根命名空间
- abstract="true" 可声明抽象包，仅用于被继承，自身不能定义 Action
- 父 package 必须在子 package 之前定义，否则 extends 失效
Action 与 Result 配置
每个 Action 定义了请求路径、处理类及返回逻辑视图的映射关系：
- action 的 name 对应 URL 中的 action 名（如 login.action 中的 login），同一 package 内不可重复
- class 属性 指向实现类全限定名，未指定时默认使用 com.opensymphony.xwork2.ActionSupport
- method 可指定执行的具体方法，默认为 execute()
- result 的 name 必须与 Action 方法返回值完全一致（如 return "success";）
- type 属性 默认为 dispatcher（转发到 JSP），也可设为 redirect、redirectAction、stream 等
- 支持
定义跨 Action 共享的结果，比如全局 error.jsp 映射到 input
模块拆分与 include 引入
大型项目推荐按业务模块拆分配置，提升可读性和协作效率：
- 用
引入外部 XML 文件 - 被引入文件结构与 struts.xml 相同，也以
为根，但不需 DTD 声明 - 所有 include 必须放在
之前，否则可能因加载顺序导致找不到父 package - 常见拆分方式：struts-system.xml、struts-user.xml、struts-order.xml 等，按需组织
基本上就这些。struts.xml 不复杂但容易忽略细节，比如 DTD 版本错位、package 加载顺序颠倒、namespace 拼写错误，都会导致 404 或拦截器失效。保持结构规范，再配合 devMode 调试，能省下大量排错时间。
