RSpec/RSwag中如何指定Decimal Schema？解决字段返回字符串校验失败问题

这个报错的核心成因是Rails生态下的固有序列化行为：数据库decimal类型字段在默认JSON序列化流程中，会被自动转为字符串类型输出，以此规避二进制浮点数的精度丢失问题。这种序列化逻辑和RSwag基于OpenAPI规范的强类型Schema校验规则天然冲突。如果为了通过测试直接把所有字段的Schema类型改成string，会彻底失去Swagger文档的类型约束价值，前期投入的接口文档成本就完全没有意义。

1. 全局统一修正序列化逻辑（首选方案） #

从源头解决decimal字段输出类型不匹配的问题，不需要逐接口调整Schema定义，一次修改即可覆盖所有接口场景：

• 在项目初始化目录下新增JSON序列化配置文件（如config/initializers/big_decimal_json_serializer.rb），重写BigDecimal类型的默认序列化输出规则
• 示例实现代码：

# 让BigDecimal类型字段默认输出为数值类型，匹配OpenAPI number规范
class BigDecimal
  def as_json(*)
    # 高精度场景可根据业务需求指定保留位数，规避浮点精度误差
    to_f.round(2)
  end
end

• 方案优势：全局生效后所有decimal字段的输出类型会和Schema定义完全一致，RSwag的类型校验会直接通过，生成的Swagger文档的类型描述和接口实际行为完全匹配，不会给前端开发带来歧义。

2. 序列化层按需调整（存量系统适配方案） #

如果项目存在部分旧接口依赖decimal字段输出为字符串的逻辑，不方便全局覆盖默认行为，可以在当前接口使用的序列化器（ActiveModel::Serializer、Blueprinter等）中，单独对需要数值输出的字段做类型转换：

# 示例：Job模型对应的序列化器
class JobSerializer < Blueprinter::Base
  fields :id, :title, :description, :budget, :awarded, :created_at, :updated_at
  # 单独将decimal类型的budget字段转为浮点数输出
  field :budget do |job|
    job.budget.to_f
  end
end

• 方案优势：调整粒度可控，不会影响存量接口的原有行为，适合迭代阶段的存量系统改造。

你当前编写的Schema定义存在两个不符合OpenAPI规范的问题，建议同步调整，避免后续出现无意义的校验报错：

• OpenAPI规范中没有原生的datetime类型，原代码里created_at、updated_at的定义需要调整为和date字段一致的格式，才会被RSwag正确识别：

# 原错误定义
created_at: { type: :datetime},
updated_at: { type: :datetime}

# 修正后的标准定义
created_at: { type: :string, format: 'date-time' },
updated_at: { type: :string, format: 'date-time' }

• 不建议为了通过测试放宽budget字段的类型校验（比如定义为同时支持string和number类型），这种操作会让Swagger文档对前端产生类型误导，同时失去Schema校验提前发现接口问题的核心价值。

需规避的低价值解法：直接关闭RSwag的Schema校验、把所有字段类型都改成string兼容校验。这类操作本质上是放弃了接口契约校验的核心能力，长期来看会大幅增加前后端联调的沟通成本。

内容的提问来源于stack exchange，提问作者s89_