ArangoDB通过REST API插入文档添加额外参数报错如何解决

核心结论 #

ArangoDB 默认为无 Schema 设计，不需要预先定义字段结构即可插入携带任意自定义参数的文档。你遇到的 REST API 插入报错问题，和 Schema 无关，基本是请求格式不规范导致的。 #

报错原因排查及正确操作步骤 #

常见报错原因 #

• 未正确设置请求头：发送 POST 请求时没有指定 Content-Type: application/json，ArangoDB 无法识别非 JSON 格式的请求体参数，仅能识别路径/查询参数中的 _key 字段
• 请求体 JSON 存在语法错误：比如引号不配对、末尾多余逗号、字段名未加双引号等
• 误用系统保留字段：自定义字段名使用了 _id、_rev 等 ArangoDB 系统保留字段，除 _key、_from、_to 外不建议自定义下划线开头的字段

正确的 REST API 插入示例 #

请求信息如下：

• 请求方法：POST
• 请求地址：/_api/document/你的集合名称
• 请求头必须包含：
  • Authorization: 你的鉴权信息（比如Bearer xxx或者基础认证字符串）
  • Content-Type: application/json
• 请求体示例：

{
  "_key": "自定义的文档key",
  "product_name": "智能手表",
  "price": 1299,
  "stock": 200,
  "specs": {
    "screen": "1.4英寸",
    "battery": "300mAh"
  }
}

关于Schema的补充说明 #

默认状态下所有集合都关闭了Schema校验，和Web界面的写入逻辑完全一致，只要请求格式符合要求，任意自定义字段都可以正常写入。如果你需要对字段格式做强制校验，可以手动在集合配置中开启Schema规则，该操作属于可选配置，不是写入文档的前置要求。

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