Rails应用JSON API Resources：邮箱应返回字符串还是数组？

从API设计的最佳实践和前后端职责划分来看，返回数组是更合理的选择，理由如下：

• 符合JSON语义：数组是JSON原生的集合类型，用来表示一组邮箱比字符串更直观。客户端可以直接对数组进行遍历、验证、筛选等操作，无需额外编写字符串拆分、清洗的逻辑，减少出错概率。
• 职责清晰解耦：API资源层的核心是提供结构化的数据表示，而不是适配特定UI的展示格式。将“数组转逗号分隔字符串”的逻辑放在UI层，后端不需要关心前端用什么组件展示数据，前后端各司其职，后续修改UI或数据结构时更灵活。
• 扩展性更强：如果后续业务需要对单个邮箱做独立操作（比如单独删除、验证有效性、批量编辑），数组格式可以直接支持；而字符串格式需要客户端先拆分，增加了不必要的复杂度。
• 贴近存储真实结构：你的数据库中实际存储的是JSON序列化的数组，返回数组格式避免了不必要的转换，数据传递更直接。

关于你提到的“返回与接收时一致的格式”，其实接收时的逗号分隔字符串只是输入适配——因为前端用文本框收集用户输入，所以后端做了字符串转数组的处理，但这并不要求输出必须沿用输入格式。API的输入和输出可以独立设计：输入适配用户操作习惯，输出提供最易用的结构化数据。

如果确实有部分客户端需要逗号分隔的字符串，可以考虑两种方案：

1. 新增一个可选字段（比如support_emails_display）专门返回字符串格式，保留support_emails字段为数组，兼顾不同需求。
2. 让客户端自行处理数组转字符串的逻辑，这在前端是非常简单的操作（比如JavaScript中用array.join(', ')）。

修改后的资源层代码示例：

def support_emails
  model.support_emails
end

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