Strapi /auth/local接口错误密码等登录场景返回500内部服务器错误求助

环境信息

• Strapi版本：4.11.4
• 操作系统：Windows 11
• 数据库：Postgres
• Node版本：14.19.1
• NPM版本：6.14.16

问题回顾 #

使用错误密码、未确认账户或被封禁账户登录时，/auth/local接口返回500内部服务器错误，而非对应的业务提示，但控制台可查看错误日志，升级Strapi版本后问题仍存在。

解决方案 #

1. 修复全局错误处理逻辑 #

默认错误中间件可能未正确捕获auth类业务错误，可自定义中间件覆盖：

• 创建或修改src/middlewares/error.js：

module.exports = (strapi) => {
  return async (ctx, next) => {
    try {
      await next();
    } catch (err) {
      ctx.status = err.status || 500;
      // 针对性捕获auth相关业务错误
      const authErrorMessages = ['Invalid credentials', 'Account not confirmed', 'Account blocked'];
      if (authErrorMessages.some(msg => err.message.includes(msg))) {
        ctx.status = 400;
        ctx.body = {
          error: {
            message: err.message,
            status: ctx.status
          }
        };
      } else {
        ctx.body = {
          error: {
            message: err.message || 'Internal Server Error',
            status: ctx.status
          }
        };
      }
      strapi.log.error(err);
    }
  };
};

• 在config/middlewares.js中确保该中间件注册在strapi::errors之后：

module.exports = [
  'strapi::errors',
  './src/middlewares/error',
  'strapi::security',
  'strapi::cors',
  'strapi::poweredBy',
  'strapi::logger',
  'strapi::query',
  'strapi::body',
  'strapi::session',
  'strapi::favicon',
  'strapi::public',
];

2. 自定义Auth控制器覆盖登录逻辑 #

直接重写默认登录方法，显式处理各类错误场景：

• 创建src/api/auth/controllers/auth.js：

const { sanitize } = require('@strapi/utils');
const { createCoreController } = require('@strapi/strapi').factories;

module.exports = createCoreController('plugin::users-permissions.auth', ({ strapi }) => ({
  async callback(ctx) {
    try {
      const { identifier, password } = ctx.request.body;
      // 查询用户（支持邮箱/用户名）
      const user = await strapi.query('plugin::users-permissions.user').findOne({
        where: { email: identifier } || { username: identifier },
      });

      if (!user) return ctx.badRequest('Invalid credentials');
      if (!user.confirmed) return ctx.badRequest('Account not confirmed');
      if (user.blocked) return ctx.badRequest('Account blocked');
      
      // 验证密码
      const validPassword = await strapi.plugins['users-permissions'].services.user.validatePassword(password, user.password);
      if (!validPassword) return ctx.badRequest('Invalid credentials');

      // 生成令牌并返回结果
      const jwt = strapi.plugins['users-permissions'].services.jwt.issue({ id: user.id });
      const sanitizedUser = await sanitize.contentAPI.output(user, strapi.getModel('plugin::users-permissions.user'));
      
      ctx.send({ jwt, user: sanitizedUser });
    } catch (err) {
      strapi.log.error(err);
      return ctx.internalServerError('Login failed, please try again later');
    }
  },
}));

• 重启Strapi服务后测试登录场景。

3. 检查Postgres数据库权限 #

确保Strapi数据库用户拥有users-permissions_user表的读写权限，避免因查询失败触发500错误：

-- 替换your_strapi_db_user为实际数据库用户名
GRANT SELECT, INSERT, UPDATE, DELETE ON TABLE "users-permissions_user" TO your_strapi_db_user;
GRANT USAGE, SELECT ON SEQUENCE "users-permissions_user_id_seq" TO your_strapi_db_user;

4. 清理缓存并重建项目 #

缓存残留可能导致旧逻辑生效，执行以下命令：

npm run clean
npm run build
npm run develop

5. 排查第三方插件冲突 #

若安装了额外的auth类插件，临时禁用后测试，确认是否存在插件冲突问题。

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