B站OpenAPI返回401或“invalid access_token”的根本原因是access_token必须放在Authorization请求头(Bearer格式),不能放URL或body中;且需注意token有效期、WBI签名要求及时区设置。

curl 请求 B 站 OpenAPI 时返回 401 或 “invalid access_token”
根本原因不是 token 没传,而是 access_token 必须放在请求头(Authorization: Bearer {token}),不能塞在 URL 参数或 POST body 里——B 站 OpenAPI 严格校验这个位置。
- 错误写法:
https://api.bilibili.com/x/v2/space/video?access_token=xxx&mid=123→ 会被无视 - 正确写法:用
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer xxx']) - 注意:
access_token是短期有效的(默认 2 小时),过期后必须用refresh_token换新,不能硬编码或缓存太久 - 如果用
file_get_contents(),它不支持自定义 header,必须切到curl
调用 x/v2/space/video 接口拿用户投稿列表的最小可行 PHP 示例
别碰 SDK,B 站官方没维护 PHP SDK,第三方库大多过期或漏签名逻辑。直接 curl 最稳。
- 必须带
mid(目标用户的 UID),不是昵称或 UID 字符串,是纯数字(如202324) - 分页靠
pn(页码)和ps(每页数量),最大ps=30,超过会截断 - 响应是 JSON,用
json_decode($res, true)解析,检查['code'] === 0再取['data']['list']['vlist'] - 示例片段:
$ch = curl_init(); curl_setopt($ch, CURLOPT_URL, 'https://api.bilibili.com/x/v2/space/video?mid=202324&pn=1&ps=20'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $access_token]); $res = curl_exec($ch); curl_close($ch); $data = json_decode($res, true); if ($data['code'] === 0) { foreach ($data['data']['list']['vlist'] as $v) { echo $v['title'] . "\n"; } }
PHP 中处理 B 站返回的视频发布时间(created 字段)
created 是 Unix 时间戳(秒级),但 PHP 的 date() 默认按本地时区解析,而 B 站所有时间都基于东八区(UTC+8)——不显式设时区,时间会差 8 小时。
- 别用
date('Y-m-d', $v['created'])直接格式化 - 先设时区:
date_default_timezone_set('Asia/Shanghai'),再date() - 或者更稳妥:用
DateTime显式指定时区:(new DateTime())->setTimestamp($v['created'])->setTimezone(new DateTimeZone('Asia/Shanghai')) - 注意:B 站接口不返回 ISO 格式时间字符串,别指望自动识别时区
为什么用 file_get_contents() 调 x/space/wbi/arc/search 会失败
这个接口强制要求 WBI 签名(即 URL 中的 wts 和 w_rid 参数),而签名依赖动态生成的 img_key 和 sub_key,它们得先从 https://api.bilibili.com/x/web-interface/nav 或 /x/web-interface/wbi/img 拿到——file_get_contents() 无法做两步请求 + 拼参数。
立即学习“PHP免费学习笔记(深入)”;
- WBI 签名不是简单哈希,要拼接字符串、base64、md5,还涉及固定 salt,PHP 里得手写逻辑(B 站没公开完整规则,得逆向 JS)
- 目前稳定可用的 PHP 实现集中在 GitHub 上几个活跃仓库(搜 “bilibili-wbi-php”),但要注意它们是否更新了 2024 年的新 salt
- 如果你只是查自己账号的视频,绕开 WBI:用
x/v2/space/video(需登录态);想搜别人公开视频,才必须上 WBI



















