使用Strapi登录或注册时返回405(Method Not Allowed)错误如何解决？

HTTP 405错误的核心含义是请求方法不被目标接口允许，针对Strapi的登录、注册认证接口，出现该错误的常见原因和解决方法如下：

常见产生原因 #

• 请求方法不匹配：Strapi官方的用户注册、登录接口默认仅支持POST请求，如果误用了GET/PUT/DELETE等其他请求方法，会直接返回405错误。
• 接口路径拼写错误：Strapi用户系统默认的注册路径是/api/auth/local/register，登录路径是/api/auth/local，路径拼写错误、多/少后缀、大小写不对都可能触发路由规则匹配错误，返回405。
• CORS配置未放行请求方法：如果是跨域请求，Strapi的CORS配置中没有允许对应请求方法，也会触发405错误。
• 用户权限插件未启用：Strapi的用户认证功能依赖Users & Permissions插件，如果该插件被禁用，对应认证接口不会注册，请求时会返回405。
• 自定义路由覆盖了默认认证路由：如果自行编写的自定义路由规则和默认认证路由的路径重复，且自定义路由配置的请求方法不包含当前使用的POST，也会触发该错误。

对应解决方法 #

• 校验请求方法：确保登录、注册请求的方法为POST，可直接在Insomnia的请求方法下拉栏确认调整。
• 核对接口路径：

  注册接口默认路径：POST /api/auth/local/register
  登录接口默认路径：POST /api/auth/local
  确认路径没有拼写错误，不要遗漏/api前缀，大小写和分隔符与官方默认规则一致。

• 调整CORS配置：打开Strapi项目下的config/middlewares.js，找到cors配置项，确保allowedMethods数组中包含POST，参考配置如下：

  module.exports = [
    // 其他中间件配置
    {
      name: 'strapi::cors',
      config: {
        enabled: true,
        origin: ['*'], // 生产环境建议替换为实际业务域名
        allowedMethods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'],
        allowedHeaders: '*',
      }
    }
  ]
  

• 确认插件启用状态：进入Strapi后台的插件管理页面，确认Users & Permissions插件处于启用状态，如被禁用手动开启后重启Strapi服务即可。
• 排查自定义路由冲突：检查项目中src/api/目录下的自定义路由配置，确认没有路径和/api/auth/local/*重复的规则，如有冲突调整自定义路由的路径即可。

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