使用Passport.js无法获取Twitter用户邮箱ID的技术问题

这个问题其实是Twitter API的权限限制导致的——Twitter默认不会在OAuth流程中返回用户邮箱，必须完成两个关键配置才能拿到：

第一步：在Twitter开发者后台开启邮箱权限 #

你需要登录你的Twitter开发者账号，找到对应的App，完成以下设置：

• 进入「User authentication settings」页面（在App的Settings菜单下）
• 在「Permissions and features」部分，勾选「Request email addresses from users」权限
• 保存设置，必要时可能需要提交简单的审核（说明你的App需要邮箱的用途，一般很快通过）

第二步：在Passport策略配置中添加邮箱请求参数 #

在你的TwitterStrategy初始化配置里，必须加上includeEmail: true，明确告诉Twitter API你需要获取用户邮箱：

const TwitterStrategy = require('passport-twitter').Strategy;

module.exports = (passport, User) => {
  passport.use(new TwitterStrategy({
    consumerKey: 'paLCHei1bz8uG5mzNK3ZmvWy7',
    consumerSecret: 'djwTrPntW6T2hm3EJ6eIvUrqObMSymgKn6B1foMQyNeypjtbIK',
    callbackURL: 'http://localhost:3000/auth/twitter/callback',
    passReqToCallback: true,
    includeEmail: true // 新增这一行，请求获取邮箱权限
  }, (req, accessToken, tokenSecret, profile, done) => {
    // 先做容错处理，避免profile.emails不存在导致报错
    const userEmail = profile.emails?.[0]?.value || null;
    
    User.findOne({ 'twitter.id': profile.id }, (err, existingUser) => {
      if (err) return done(err);
      if (existingUser) return done(null, existingUser);
      
      const newUser = {
        image: profile._json.profile_image_url,
        displayName: profile.displayName,
        email: userEmail,
        twitter: {
          id: profile.id,
          email: userEmail
        }
      };
      
      User.create(newUser, (err, createdUser) => {
        done(err, createdUser);
      });
    });
  }));
};

额外注意事项 #

• 即使完成了以上配置，也不是所有用户的邮箱都能获取到：如果用户在Twitter账号里没有绑定邮箱，或者拒绝了你的App获取邮箱的请求，profile.emails仍然会是undefined，所以一定要做容错处理（比如上面代码里的可选链操作?.）
• 确保你的Twitter App已经通过了基础的认证审核，部分权限需要App处于「上线」状态才能生效

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