Strapi更新地址记录时出现404错误：PUT API调用异常

已知背景 #

• Strapi中创建了user与address一对多关联集合
• Next.js调用/api/addresses/:id执行更新/查询/删除操作时，始终返回404错误
• 已为Authenticated角色开启address的所有权限（put、create、delete、find、findOne）
• 确认目标地址存在、ID正确，且Strapi后台显示的路由/api/addresses/:id无误

排查与解决方向 #

1. 关联数据的访问过滤限制 #

Strapi默认支持按用户过滤关联数据，若开启该设置，用户只能访问自己关联的地址，否则会因Strapi过滤掉非用户所有的地址而返回404。

• 检查步骤：
  1. 进入Strapi后台，打开address内容类型的Settings -> Advanced settings
  2. 查看「Filter content by user」选项：
     • 若已勾选：确认当前请求的用户是否是该地址的关联user（即address的user字段是否指向当前用户）
     • 若无需该限制：取消勾选该选项，允许用户操作所有地址数据

2. ID类型不匹配问题 #

Strapi的ID默认有两种类型：Integer（数字）和UUID（字符串），若代码中强制转换ID类型会导致路由无效。

• 检查步骤：
  1. 在Strapi的Content-Type Builder中，查看address的ID字段类型
  2. 若ID是UUID字符串：去掉代码中Number(id)的转换，直接使用原始ID拼接路径：

     // 原代码
     const responseData = await mutateData("PUT", `/api/addresses/${Number(id)}`, payload);
     // 修改后
     const responseData = await mutateData("PUT", `/api/addresses/${id}`, payload);
     

  3. 打印拼接后的路径，确认格式与Strapi中的ID一致

3. Strapi路由缓存或未生效 #

修改内容类型后，Strapi可能未重新生成API路由，导致旧路由残留。

• 解决步骤：
  1. 完全重启Strapi服务器
  2. 删除Strapi项目根目录下的.strapi缓存文件夹，再重启服务
  3. 确认Strapi后台Content-Type Builder中address的复数名称为addresses，对应路由无误

4. 请求URL验证 #

确认Next.js生成的最终请求URL完全正确，避免代理或路径拼接错误。

• 检查步骤：
  1. 在mutateData函数中打印最终请求URL：

     console.log("Request URL:", url.toString());
     

  2. 验证getStrapiURL()返回的Strapi地址是否正确（如http://localhost:1337）
  3. 用Postman/curl直接调用Strapi的PUT /api/addresses/:id接口（携带正确的JWT Token），若Postman也返回404，说明问题出在Strapi配置而非Next.js代码

5. JWT Token有效性验证 #

确认getAuthToken()获取的Token未过期且权限正确：

• 在mutateData中打印authToken，确认Token格式正确
• 用Strapi后台的JWT验证工具（或在线工具）校验Token的有效性和包含的权限

额外提示 #

你的更新代码中返回的消息是「Address deleted successfully」，但实际执行的是更新操作，属于文案错误，建议修正为对应提示。

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