Strapi新用户首次注册触发‘timeout of 6000ms exceeded’错误求助

一、原因分析 #

1. 数据库连接池闲置断开/冷启动 #

Railway的PostgreSQL实例在闲置时段会自动释放闲置连接，而Strapi默认连接池未配置连接预热或自动重连机制，导致首次注册请求需要重新建立数据库连接，耗时超过默认的6000ms阈值。后续请求复用已建立的连接，因此可正常执行。

2. 邮件发送逻辑阻塞主请求 #

注册流程中若同步执行确认邮件发送操作，当邮件服务（Railway内置或第三方）响应延迟时，会拖慢整个注册请求的处理时间，触发超时。此时数据库已完成用户创建，但前端收到超时错误，用户也可能因邮件发送超时未收到确认邮件。

3. Railway实例休眠节流 #

Railway的基础/免费实例在闲置后会进入休眠状态，首次请求需唤醒实例、初始化Strapi进程与数据库连接，总耗时超过6000ms。后续请求时实例处于活跃状态，响应速度恢复正常。

4. Strapi默认超时配置不足 #

Strapi默认请求超时为6000ms，首次注册请求涉及数据库连接初始化、邮件发送等多步耗时操作，容易触发超时限制。

二、解决方案 #

1. 优化数据库连接池配置 #

修改Strapi的config/database.js（或config/database.ts），调整连接池参数以保持空闲连接并延长超时时间：

module.exports = ({ env }) => ({
  connection: {
    client: 'postgres',
    connection: {
      host: env('DATABASE_HOST', 'localhost'),
      port: env.int('DATABASE_PORT', 5432),
      database: env('DATABASE_NAME', 'strapi'),
      user: env('DATABASE_USERNAME', 'strapi'),
      password: env('DATABASE_PASSWORD', 'strapi'),
      ssl: env.bool('DATABASE_SSL', false),
    },
    pool: {
      min: 2, // 保持2个常驻空闲连接
      max: 10,
      idleTimeoutMillis: 30000,
      createTimeoutMillis: 8000, // 延长连接创建超时至8秒
      acquireTimeoutMillis: 8000, // 延长连接获取超时至8秒
      testOnBorrow: true, // 借取连接时检测可用性
      testWhileIdle: true, // 空闲时定期检测连接
      evictionRunIntervalMillis: 10000, // 每10秒执行一次连接检测
    },
  },
});

2. 异步处理邮件发送逻辑 #

修改Strapi用户注册的生命周期钩子，将邮件发送放入异步任务，避免阻塞主请求：

// src/extensions/users-permissions/content-types/user/lifecycles.js
module.exports = {
  async afterCreate(event) {
    const { result } = event;
    // 用异步任务执行邮件发送
    setTimeout(async () => {
      try {
        await strapi.plugins['email'].services.email.send({
          to: result.email,
          subject: '账户注册确认',
          text: `请点击链接完成邮箱验证：${process.env.FRONTEND_URL}/verify?token=${result.emailConfirmation.token}`,
        });
      } catch (err) {
        strapi.log.error('确认邮件发送失败:', err);
      }
    }, 0);
  },
};

3. 保持Railway实例活跃 #

• 若使用Railway付费计划，为Strapi服务开启「Always On」选项，避免实例休眠。
• 若使用免费计划，通过定时任务（如GitHub Actions）每隔5分钟向Strapi健康检查接口发送请求，维持实例活跃：

  curl https://your-strapi-app.railway.app/health
  

4. 延长Strapi请求超时时间 #

在config/middlewares.js中添加超时配置，延长请求处理时间：

module.exports = [
  'strapi::errors',
  'strapi::security',
  'strapi::cors',
  'strapi::poweredBy',
  'strapi::logger',
  'strapi::query',
  'strapi::body',
  'strapi::session',
  'strapi::favicon',
  'strapi::public',
  {
    name: 'strapi::timeout',
    config: {
      timeout: 12000, // 延长至12秒
    },
  },
];

5. 前端添加请求重试机制 #

在React/Vite的注册页面，为请求添加自动重试逻辑，应对首次超时问题：

async function registerUser(userData) {
  let attempts = 0;
  const maxAttempts = 2;
  while (attempts < maxAttempts) {
    try {
      const response = await fetch(`${process.env.REACT_APP_STRAPI_URL}/api/auth/local/register`, {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify(userData),
      });
      if (response.ok) return await response.json();
      throw new Error('注册请求失败');
    } catch (err) {
      attempts++;
      if (attempts === maxAttempts) throw err;
      await new Promise(resolve => setTimeout(resolve, 1000)); // 间隔1秒重试
    }
  }
}

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