使用@astrajs/rest插入Astra DB记录时未指定ID遇404错误

问题根源 #

你的usersnew表主键id仅定义为uuid PRIMARY KEY，但未设置自动生成的默认值。Cassandra（Astra DB基于Cassandra）不会自动生成主键值，当你用POST请求不传入ID时，API无法填充必填的主键字段，最终导致请求失败（返回404是API错误码映射不精准，实际为缺少必填主键）。

解决方案 #

方案1：修改表结构，让主键自动生成UUID #

给id字段添加DEFAULT uuid()约束，这样POST请求时Astra会自动生成UUID作为主键：

ALTER TABLE mykeyspace.usersnew ALTER id SET DEFAULT uuid();

修改完成后，你原来的POST代码就能正常执行，无需传入ID字段。

方案2：POST请求手动传入UUID主键 #

如果不想修改表结构，可手动生成UUID并包含在请求体中：

// 先引入uuid库（需提前安装：npm install uuid）
const { v4: uuidv4 } = require('uuid');

const { data, status } = await astraClient.post(
    "/api/rest/v2/keyspaces/mykeyspace/usersnew", 
    {
      id: uuidv4(), // 手动生成UUID
      email: "aaa@aaa",
      name: "aaaa",
      userhandle: "handlethat"
     }
);

注：这种方式和PUT的核心区别是PUT是针对指定ID的资源进行创建/替换，POST是向集合提交创建请求，但两者都需要提供主键值（除非主键有默认生成规则）。

补充说明 #

Astra REST API的PUT和POST语义：

• PUT /keyspaces/.../table/{id}：用于创建或替换指定ID的单条记录，必须在URL中传入主键值。
• POST /keyspaces/.../table：用于创建新记录，若要自动生成主键，必须确保主键字段有默认生成函数（如uuid()），否则必须在请求体中传入主键值。

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