解决json-server中字符串数组导致的TypeError错误

在使用json-server模拟REST API时，开发者可能会遇到一个常见的错误：当尝试将字符串数组作为数据源时，启动服务会抛出TypeError: Cannot create property 'id' on string 'a'的错误。这个问题的根源在于json-server对数据结构的特殊要求。

问题本质

json-server在设计上要求所有的资源集合必须由对象数组组成，而不能直接使用原始值数组。这是因为json-server会自动为每个资源项添加一个唯一的id属性，以便实现RESTful API的标准操作（如GET、POST、PUT、DELETE等）。

当开发者尝试使用如下数据结构时：

{
  "list": ["a", "b", "c"]
}

json-server内部会尝试为每个字符串元素添加id属性，但由于JavaScript中字符串是原始类型而非对象，导致无法动态添加属性，从而抛出错误。

正确解决方案

正确的做法是将原始值包装成对象形式。例如，上面的例子应该修改为：

{
  "list": [
    { "value": "a" },
    { "value": "b" },
    { "value": "c" }
  ]
}

这种结构不仅解决了错误问题，还具有以下优点：

1. 保持了数据的语义完整性
2. 允许未来扩展更多属性
3. 符合REST API设计的最佳实践

特殊情况说明

有趣的是，有开发者发现如果json-server已经在运行状态下修改db.json文件为字符串数组格式，服务能够自动刷新并接受这种结构。这是因为热更新时json-server可能采用了不同的处理逻辑。但这种方式不稳定，不建议在生产或重要开发环境中使用。

最佳实践建议

1. 始终使用对象数组作为资源集合
2. 为每个对象包含一个明确的标识字段（如id）
3. 保持数据结构的一致性
4. 考虑使用TypeScript接口或JSON Schema来验证数据结构

通过遵循这些原则，可以避免大多数与json-server数据结构相关的问题，并构建出更健壮的API模拟环境。