17370845950

AMS 从 0.10 版起彻底移除 XML 支持，仅保留 JSON；render xml: @resource 会绕过 AMS 直接调用 Rails 默认 to_xml；推荐改用 Rails 原生 to_xml 或 fast_xml_serializer 等专用方案。

ActiveModel::Serializers（AMS）默认不支持 XML 输出，它从 0.10 版起就彻底移除了对 XML 的原生支持，只保留 JSON。如果你在 Rails 项目中看到 render json: @resource 能用 AMS，但换成 render xml: @resource 报错或忽略序列化器，这不是配置问题，而是功能已被删掉。

为什么 AMS 不再支持 XML

AMS 团队在 v0.10+ 明确将 XML 视为“非核心场景”，把维护成本和测试负担转向 JSON 主流路径。XML 支持早在 2016 年的 PR #1789 中被移除，后续版本（包括 0.10.x 和 0.9.x 的后期补丁）均不再识别 xml 格式或调用 to_xml 方法。

• 调用 render xml: @post 会绕过 AMS，直接走 Rails 默认的 ActiveRecord::Base#to_xml
• 即使你定义了 PostSerializer，它对 XML 请求完全无响应
• format.xml { render xml: @post

  

  } 同样无效，AMS 的 render DSL 不注册 XML MIME type

替代方案：用 Rails 原生 to_xml + 自定义 options

如果必须输出 XML，最轻量、最可控的方式是放弃 AMS，改用 Rails 内置的 to_xml，并手动控制字段和嵌套。它虽不如 AMS 灵活，但足够稳定，且能精确匹配老系统或第三方接口要求。

• 在控制器里显式调用：@post.to_xml(include: [:author], except: [:updated_at])
• 支持 methods: 添加计算字段，如 methods: :full_title
• 用 skip_instruct: true 避免重复的 （Rails 7+ 默认不加，旧版需注意）
• 若需深度定制（比如重命名节点、添加属性），可传 builder: 参数，配合 XmlBuilder 类

def show
  render xml: @post.to_xml(
    include: { author: { only: [:id, :name] } },
    except: [:created_at],
    methods: [:published?],
    root: "article"
  )
end

硬要集成 AMS？只能自己 patch 或换库

强行让 AMS 输出 XML 属于逆向工程，不推荐生产使用。但如果你已有大量 AMS 序列器逻辑、且 XML 是硬性需求，有两个现实路径：

• 降级到 AMS 0.9.3（最后一个带 XML 支持的版本），但它不兼容 Rails 7，且已停止维护，存在安全风险
• 写一个中间层：用 AMS 渲染成 Hash，再用 Hash.from_xml 或 Ox.dump 转 XML —— 但嵌套关系、类型（如 type="integer"）、空值处理需自行补全，容易出错
• 更务实的选择是切换到 fast_xml_serializer 或直接用 Ox 手写模板，尤其当 XML 结构固定时，性能和可控性反而更高

真正麻烦的不是“怎么输出 XML”，而是 XML 本身缺乏标准序列化契约（不像 JSON Schema 或 OpenAPI）。同一个 Post 模型，在不同系统里可能要求 true 或 1。AMS 的抽象层在这里反而成了累赘——不如直面 XML 的细节。