bearer token未正确配置或未被携带会导致401错误,应通过authorization面板手动输入、环境变量引用(如{{auth_token}})或预请求脚本自动获取并注入,再通过headers面板验证authorization头是否为“bearer ”格式。

如果您在Hoppscotch中测试需要身份鉴权的API接口,但请求始终返回401 Unauthorized错误,则很可能是Bearer Token未正确配置或未被携带。以下是配置Bearer Token认证的具体操作方法:
一、通过Authorization面板直接配置Bearer Token
该方式适用于手动输入已知有效Token的场景,操作快捷,Token值直接嵌入请求头 Authorization: Bearer
1、在Hoppscotch主界面右上角点击Authorization标签页。
2、在Type下拉菜单中选择Bearer Token。
3、在Token输入框中粘贴您的有效访问令牌(如eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...)。
4、点击发送按钮发起请求,观察响应状态码与Header中是否包含Authorization: Bearer
二、使用环境变量动态注入Bearer Token
该方式可避免硬编码敏感令牌,支持多环境切换(如dev/staging/prod),Token值通过环境变量引用,提升安全性与复用性。
1、点击左上角Environments图标,进入环境管理界面。
2、点击+ Add Environment创建新环境,命名为“production”或对应环境名。
3、在Key列填写auth_token,Value列粘贴实际令牌值,保存环境。
4、返回Authorization面板,Type选择Bearer Token,Token栏输入{{auth_token}}(注意双大括号语法)。
5、确保右上角环境选择器已切换至刚创建的环境,再发送请求。
三、通过预请求脚本自动获取并设置Bearer Token
该方式适用于Token具有时效性(如OAuth2 Access Token需定期刷新)的场景,通过脚本在每次请求前调用登录接口获取新Token,并写入Authorization头。
1、点击请求区域下方的Pre-request Script标签页。
2、输入以下JavaScript代码(以标准OAuth2密码模式为例):
const loginUrl = "https://api.example.com/auth/login";
const credentials = { username: "test", password: "pass123" };
pm.sendRequest({ method: "POST", url: loginUrl, body: { mode: "raw", raw: JSON.stringify(credentials) } }, (err, res) => {
if (!err && res.code === 200) {
const token = res.json().access_token;
pm.request.headers.add({ key: "Authorization", value: "Bearer " + token });
}
});
3、确保当前请求的URL与脚本中loginUrl域名同源或已配置CORS白名单。
4、关闭Authorization面板中的任何手动Token配置,仅依赖脚本注入。
四、验证Bearer Token是否生效
该步骤用于确认Token已正确附加至请求,且服务端能成功解析,避免因格式错误、过期或权限不足导致失败。
1、在Hoppscotch中打开Headers面板,勾选Show system headers。
2、发送请求后,在Headers面板中查找Authorization字段,其值应为Bearer eyJhbGciOi...格式,且无多余空格或换行。
3、若响应体含invalid_token或expired_token,说明Token已失效,需重新获取。
4、检查响应Header中是否返回WWW-Authenticate: Bearer error="invalid_token"等标准RFC 6750错误提示。











