Tweepy/X API 重置令牌并启用 Read & Write 后仍返回 401
结论
Tweepy 调用 API v2 时不需要增加其他认证步骤。现有代码采用 OAuth 1.0a 用户身份认证,可用于 API v1.1 的媒体上传,也可用于 API v2 的推文创建。
问题更可能出在凭据上。verify_credentials() 已返回错误码 89 - Invalid or expired token,说明 access token 和当前 app 的 consumer key 无法组成有效的 OAuth 1.0a 凭据。继续调用 /2/users/me 或 create_tweet() 也会得到 401 Unauthorized。
重新生成一套匹配的凭据
在 Developer Portal 中依次完成以下操作:
- 打开目标 Project 下实际使用的 app。
- 在 User authentication settings 中启用 OAuth 1.0a。
- 将 App permissions 设置为 Read and Write。
- 保存权限设置。
- 重新生成 Access Token and Secret。
- 复制该 app 的 API Key and Secret。
- 更新程序或部署平台中的四个环境变量,然后重启进程。
操作顺序会影响权限。Access Token 通常包含生成时的用户授权和权限信息。如果先生成 token,之后才将权限从 Read 改为 Read and Write,旧 token 不会自动获得写权限。修改权限后需要重新生成 token。
以下四项凭据必须来自同一个 app 和同一套环境:
consumer_key = API Key
consumer_secret = API Key Secret
access_token = Access Token
access_token_secret = Access Token Secret
OAuth 2.0 的 Client ID、Client Secret 和 Bearer Token 不能填入这些参数。
用最小代码验证认证
先只验证用户身份,暂时不要上传媒体或发布推文:
import os
import tweepy
api_key = os.environ["X_API_KEY"].strip()
api_secret = os.environ["X_API_SECRET"].strip()
access_token = os.environ["X_ACCESS_TOKEN"].strip()
access_secret = os.environ["X_ACCESS_TOKEN_SECRET"].strip()
client = tweepy.Client(
consumer_key=api_key,
consumer_secret=api_secret,
access_token=access_token,
access_token_secret=access_secret,
)
me = client.get_me(user_auth=True)
print(me.data)
接着测试 API v1.1:
auth = tweepy.OAuth1UserHandler(
api_key,
api_secret,
access_token,
access_secret,
)
api = tweepy.API(auth)
user = api.verify_credentials()
print(user.id, user.screen_name)
两个测试要使用同一组四项凭据。如果 verify_credentials() 仍然返回错误码 89,先处理 token 无效的问题,不必继续排查媒体上传或 create_tweet()。
完整发布代码
认证通过后,可以通过 API v1.1 上传媒体,再使用 API v2 创建推文:
import os
from typing import Optional
import tweepy
class XBot:
def __init__(
self,
api_key: str,
api_secret: str,
access_token: str,
access_secret: str,
):
api_key = api_key.strip()
api_secret = api_secret.strip()
access_token = access_token.strip()
access_secret = access_secret.strip()
self._v2 = tweepy.Client(
consumer_key=api_key,
consumer_secret=api_secret,
access_token=access_token,
access_token_secret=access_secret,
)
auth = tweepy.OAuth1UserHandler(
api_key,
api_secret,
access_token,
access_secret,
)
self._v1 = tweepy.API(auth)
def post(self, text: str, image_path: Optional[str] = None) -> str:
media_ids = None
if image_path and os.path.exists(image_path):
media = self._v1.media_upload(filename=image_path)
media_ids = [media.media_id]
response = self._v2.create_tweet(
text=text,
media_ids=media_ids,
user_auth=True,
)
return str(response.data["id"])
OAuthHandler 仍然可以用于 OAuth 1.0a。这里使用 OAuth1UserHandler,能更清楚地表明代码采用的是用户身份认证。更换处理器不会修复无效 token。
常见的凭据问题
重新生成凭据后如果仍然返回 401,可依次检查以下问题:
- 部署环境中是否还保存着旧 token。修改本地
.env不会同步更新 Docker、CI/CD、云函数或托管平台中的变量。 - 环境变量是否填反,尤其是
access_token和access_token_secret。 - 凭据中是否带有换行、空格或引号。读取后调用
.strip()可以去掉首尾空白。 - API Key 和 Access Token 是否来自不同的 app。
- Access Token 是否生成于 Read and Write 权限设置之前。
- 运行中的进程是否已经重启。
- 系统时间是否明显不准。OAuth 1.0a 签名包含时间戳,时间偏差过大可能导致认证失败。
- token 所属的 X 账号或 app 是否已被撤销授权、暂停或删除。
排查时,可以记录凭据长度和首尾少量字符,确认部署环境是否加载了新值。不要输出完整 secret:
def fingerprint(value: str) -> str:
value = value.strip()
return f"{value[:4]}...{value[-4:]} (len={len(value)})"
print("api_key:", fingerprint(api_key))
print("access_token:", fingerprint(access_token))
这些信息也不要写入公开日志。
直接请求 /2/users/me 时的认证方式
使用 requests 直接调用 /2/users/me 时,不能将 OAuth 1.0a Access Token 直接写成:
Authorization: Bearer <access_token>
Bearer Token 和 OAuth 1.0a Access Token 是两种不同的凭据。OAuth 1.0a 请求需要使用 consumer secret 和 access token secret 进行签名。使用 Tweepy 并传入 user_auth=True 后,Tweepy 会自动完成签名。
直接请求返回 401,无法单独说明 API v2 配置有问题。还需要确认请求使用的是 Bearer Token、OAuth 2.0 用户令牌,还是经过正确签名的 OAuth 1.0a 请求。
Project 配置与访问权限
app 关联到 Project 是使用相关 API 的配置条件之一,但无法修复不匹配或已经失效的 OAuth token。Read and Write 控制授权范围,也无法让无效凭据通过认证。
认证成功后,如果当前开发者账号的 API 套餐不允许访问某个 endpoint,可能会返回其他权限或访问级别错误。当前错误也出现在 verify_credentials() 中,并且明确包含错误码 89,因此应先检查凭据是否匹配以及 token 是否有效。
备注:内容仅供参考。
