Rails+MySQL中SQL别名引发日期格式差异的技术咨询

1. 为何不同别名会导致结果格式不同？ #

核心原因是Rails ActiveRecord的自动类型转换机制：

• 当你使用原字段名date_agreed作为别名时，ActiveRecord会关联到数据库元数据中该字段的DATE类型定义，自动将查询结果转换为Ruby的Date对象。在序列化为JSON返回前端时，Rails默认逻辑会把Date对象转换成包含默认时间（00:00:00）和服务器时区的完整格式字符串。
• 当你使用全新别名date_agrd时，ActiveRecord无法匹配到原字段的类型信息，会直接把DATE_FORMAT返回的内容当作普通字符串处理，不会触发类型转换，因此前端收到的就是纯日期格式的字符串。

2. 原生DATE类型字段为何返回带时间的格式？ #

MariaDB的DATE类型本身仅存储日期信息，但问题出在Rails的类型映射与序列化逻辑：

• ActiveRecord会将MariaDB的DATE字段映射为Ruby的Date对象，该对象本身只包含日期数据。
• 但在生成JSON响应时，Rails默认的序列化规则（如to_json方法）会把Date对象转换为包含默认时间（00:00:00）和服务器时区的格式字符串，最终导致前端收到带时间的结果。

可选解决思路 #

如果需要前端稳定获取纯日期格式，可采用以下方式：

• 自定义序列化逻辑：在模型中重写as_json方法，指定字段的格式化规则：

def as_json(options = {})
  super(options.merge(only: [..., :date_agreed], methods: :formatted_date_agreed))
end

def formatted_date_agreed
  date_agreed&.strftime('%Y-%m-%d')
end

• 查询时强制返回字符串：使用非原字段名的别名执行查询，让结果以字符串形式返回：

YourModel.select("DATE_FORMAT(sd.date_agreed, '%Y-%m-%d') AS date_agreed_str")

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