Rails7中ActiveModel Attributes数值校验器不生效问题排查

核心问题是 ActiveModel::Attributes 的类型转换优先级高于校验：

• 你给rows声明了:integer类型后，任何赋值给该属性的值都会先按整数规则做强制转换：小数字符串/浮点数会被截断小数部分取整，无法解析为数字的字符串会被转为0，整个转换过程在校验运行前就完成了。
• 等校验触发时，拿到的已经是转换后的整数值，numericality: { only_integer: true } 检查到值本身就是整数，自然不会抛出非整数错误；如果转换后的值刚好落在1~50区间，连范围校验也会直接通过，完全感知不到原始输入是非法值。
• 第一次测试失败的原因很直接：Shoulda Matchers传入测试值"0.1"后，被提前转成0，最终抛出的是「不在允许范围内」的错误，而非matcher预期的「必须为整数」错误，和测试预期不匹配。
• 第二次调整后测试通过但实际运行失效，是因为你把范围校验合并到numericality配置后，matcher默认用整数值做测试用例，自然可以通过，但实际场景下非整数输入被提前静默转换的问题根本没有解决。

核心思路是不要让属性层的强制类型转换提前吞掉非法输入，要让校验逻辑先拿到原始输入做合法性判断，有两种常用实现：

方案1：换用不会截断原始值的属性类型 #

把属性类型从:integer换成:decimal（保留小数精度）或者:string，让原始输入可以直接传递到校验层：

# app/models/grid.rb
class Grid
  include ActiveModel::Model
  include ActiveModel::Attributes

  # 用decimal类型接收数值，不会提前截断小数部分，比string类型更方便做数值校验
  attribute :rows, :decimal, precision: 10, scale: 2
  # 注意校验顺序：先校验是否为整数，再校验数值范围
  validates :rows, 
            numericality: { 
              only_integer: true,
              greater_than_or_equal_to: 1,
              less_than_or_equal_to: 50
            }

  # 业务逻辑里需要用整数值时，调用该方法获取即可
  def rows_to_i
    rows.to_i
  end
end

这种实现下，传入"0.1"、3.14这类非整数时，属性会保留原始小数值，only_integer校验会正常触发错误；传入非数字字符串会被识别为非法数值，触发数值校验报错，完全符合预期。

方案2：自定义严格整数类型，不做静默非法转换 #

如果一定要让属性最终存整数值，可以自定义一个严格整数类型，遇到无法合法转为整数、或者原始值带小数的情况，不做截断转换，直接返回原始值交给校验处理：

# app/types/strict_integer_type.rb
class StrictIntegerType < ActiveModel::Type::Integer
  def cast(value)
    # 浮点数、带小数点的字符串直接返回原始值，不做截断
    return value if value.is_a?(Float)
    return value if value.is_a?(String) && value.include?('.')
    # 合法整数走原有转换逻辑
    super
  end
end

# 初始化时注册自定义类型，可放在config/initializers/types.rb中
ActiveModel::Type.register(:strict_integer, StrictIntegerType)

模型中替换为自定义类型即可：

class Grid
  include ActiveModel::Model
  include ActiveModel::Attributes

  attribute :rows, :strict_integer
  validates :rows, numericality: { only_integer: true, in: 1..50 }
end

修复后原有的Shoulda Matchers测试不需要额外调整即可正常通过——因为属性不会再提前把"0.1"这类测试值转成0，matcher可以正确捕获到「必须为整数」的校验错误，测试逻辑和实际运行逻辑会保持一致。

不要为了临时过测试去修改校验错误消息的匹配规则，本质问题是类型转换和校验的执行顺序问题，解决顺序问题后逻辑自然通顺。

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