Node.js+Express中passport-facebook-token实现遇500内部服务器错误

1. 低级拼写错误：sendSuccesResponse 命名错误 #

路由代码里的 sendSuccesResponse 少写了一个字母s，如果你的工具函数实际命名是 sendSuccessResponse，调用时的拼写错误会直接抛出 ReferenceError，这是导致500错误的常见原因。

2. 未处理profile字段为空的边界情况 #

Facebook返回的用户信息中，emails或photos数组可能为空（比如用户未公开邮箱、未设置头像），直接访问 profile.emails[0].value 或 profile.photos[0].value 会触发 Cannot read properties of undefined (reading 'value') 类型错误，导致数据库保存失败并传递错误给passport，最终返回500。

修复代码：

const newUser = new User({
  name: profile.displayName || 'Unknown User',
  email: profile.emails?.[0]?.value || null, // 用可选链避免空值报错
  facebookProvider: { id: profile.id, token: accessToken },
  imageProfile: profile.photos?.[0]?.value || null,
});

3. User.findOne 回调的错误处理逻辑漏洞 #

原代码中，当User.findOne查询出错时（比如数据库连接异常），会直接执行 return done(error, user)，此时user可能为null，错误会被直接传递给Express导致500。需要优先处理查询错误：

修复代码：

User.findOne(
  { 'facebookProvider.id': profile.id },
  (error: any, user: any) => {
    if (error) { // 先处理数据库查询错误
      return done(error);
    }
    if (!user) {
      const newUser = new User({
        name: profile.displayName || 'Unknown User',
        email: profile.emails?.[0]?.value || null,
        facebookProvider: { id: profile.id, token: accessToken },
        imageProfile: profile.photos?.[0]?.value || null,
      });
      newUser.save((saveError, result) => {
        if (saveError) {
          return done(saveError);
        }
        return done(null, result);
      });
    } else {
      return done(null, user); // 无错误时传递null和用户对象
    }
  }
);

4. 确认JWT配置有效性 #

检查 config.JWT_SECRET_KEY 是否为空，config.TOKEN_LIFE_TIME 格式是否符合jsonwebtoken要求（比如'1h'、'7d'）。如果配置缺失或格式错误，jwt.sign会抛出错误导致500。

快速排查步骤 #

1. 添加Express错误处理中间件，打印详细错误栈：

app.use((err: any, req: Request, res: Response, next: NextFunction) => {
  console.error('服务器错误:', err.stack);
  res.status(500).json({ message: '服务器内部错误' });
});

2. 测试时模拟用户未提供邮箱/头像的场景，验证空值处理逻辑是否生效。
3. 确认请求中token的传递方式：passport-facebook-token 默认从请求body、query参数或Authorization: Bearer <token>头中获取token，确保传递方式符合预期。

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