使用PassportJS配置Twitter OAuth时遇权限及令牌错误

为什么OAuth v1.1会报错 #

APIError: You currently have Essential access which includes access to Twitter API v2 endpoints only. If you need access to this endpoint, you’ll need to apply for Elevated access via the Developer Portal.

你代码里用的TwitterStrategy属于passport-twitter包，这个策略在完成OAuth授权后，会自动调用Twitter API v1.1的/account/verify_credentials接口拉取用户信息。而你的账号只有Essential访问权限，这个权限只允许调用v2版本的API，所以会触发这个错误——哪怕你没主动写API调用代码，策略底层会默认执行。

方案1：升级到Elevated访问权限 #

如果想继续用OAuth v1.1，去Twitter开发者后台申请Elevated权限即可（免费），申请通过后就能访问v1.1的必要接口。另外你的代码有个小问题需要修正：

// 原代码里的回调函数err未定义，改为null
(accessToken, refreshToken, profile, done) => {
  console.log(profile);
  return done(null, profile); // 无错误时第一个参数传null
  // User.findOrCreate({ twitterId: profile.id }, function (err, user) {
  //   return done(err, user);
  // });
}

方案2：改用Twitter OAuth 2.0（无需升级权限） #

Essential权限支持OAuth 2.0的用户认证流程，推荐用支持v2的passport-twitter2策略，步骤如下：

1. 安装依赖 #

npm install passport-twitter2

2. 修改Passport配置 #

替换原有的策略配置，注意参数名和scope的设置：

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

passport.use(new TwitterStrategy({
    clientID: TWITTER_KEY, // 对应开发者后台的API Key
    clientSecret: TWITTER_SECRET, // 对应API Secret
    callbackURL: "http://localhost:8080/api/user/auth/twitter/callback",
    passReqToCallback: true,
    scope: ['users.read'] // 必须添加这个scope才能获取用户信息
  },
  (req, accessToken, refreshToken, profile, done) => {
    console.log(profile);
    return done(null, profile); // 修正err为null
    // User.findOrCreate({ twitterId: profile.id }, function (err, user) {
    //   return done(err, user);
    // });
  }
));

3. 检查开发者后台设置 #

• 在项目的OAuth 2.0设置里，客户端类型选「Web App」
• 把http://localhost:8080/api/user/auth/twitter/callback添加到「Valid Callback URLs」列表
• 确保OAuth 2.0权限中勾选了「Read user profile and email address」（对应users.read scope）

关于passport-twitter-oauth2的无访问令牌问题 #

你之前用这个包时出现的问题，大多是因为：

• 没设置必要的scope（必须包含users.read）
• 回调URL未在Twitter后台正确配置
• 包本身的兼容性问题，建议直接换成passport-twitter2更稳定

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