You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Strapi访问localhost:1337/auth/local始终返回not found如何解决?

Strapi /auth/local 接口返回404排查处理方案
  • 优先确认Strapi版本匹配的接口路径
    • Strapi v3 版本默认登录接口为 POST /auth/local
    • Strapi v4 及以上版本所有核心插件接口统一添加了/api前缀,正确登录路径为 POST /api/auth/local,全新安装默认都是v4+版本,路径填错是404问题最高发原因
  • 检查Users & Permissions插件启用状态
    登录Strapi后台管理面板(默认地址localhost:1337/admin),在左侧插件栏确认Users & Permissions插件处于已启用状态,全新安装时如果自定义取消了该插件的勾选,所有认证相关接口都会不存在
  • 确认请求规范符合要求
    该接口仅支持POST请求,使用GET、PUT等其他请求方式访问会直接返回404;请求body需要携带identifier(可传入用户名或注册邮箱)和password两个必填参数,示例请求结构如下:
    {
      "identifier": "test@example.com",
      "password": "yourpassword"
    }
    
  • 检查自定义路由前缀配置
    如果你在/config/api.js中修改过全局路由前缀配置,需要将自定义前缀添加到接口路径前,比如你配置了全局前缀为/v1,则v4版本的登录接口路径为 POST /v1/api/auth/local
  • 重置路由缓存
    以上配置都确认无误仍返回404时,删除项目根目录下的.cache和build文件夹,重新执行npm run develop启动项目,强制Strapi重新生成全量路由规则

内容的提问来源于stack exchange,提问作者Anu

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.24 15:24:09