LongBridge API 401004 错误

[ohmanymoneygomyhome-creator]

LongBridge API 401004 错误问题总结

问题描述

使用 Python SDK (longbridge v4.0.5) 连接 LongBridge OpenAPI 时，所有 API 调用均返回 401004 token invalid 错误。

───

环境信息

项目	值
SDK版本	longbridge 4.0.5
Python版本	3.12
操作系统	Windows
App Key	9931b97275f8ed93c4bc689b10ed2575
账户ID	21331930
账户类型	Paper Trading (模拟交易)

───

错误详情

OpenApiException: (kind=ErrorKind.OpenApi, code=401004, trace_id=xxx) token invalid

───

已尝试的排查

1. ✅ 确认 Token 格式正确（JWT，带 m_ 前缀）
2. ✅ Token Payload 包含完整字段（aid, ak, bl 等）
3. ✅ 使用 Config.from_apikey_env() 初始化
4. ✅ 使用 Config.from_apikey() 直接传参
5. ✅ 确认 App Key、App Secret、Access Token 均已正确设置
6. ✅ DNS 解析正常，服务器可连接
7. ✅ SDK 能成功创建 QuoteContext 和 TradeContext
8. ❌ 所有 API 调用均返回 401004

───

关键发现

1. Token格式：获取的 Token 是 OAuth 2.0 格式（RS256 签名，含 bl=3 字段）
2. SDK认证方式：Config.from_apikey_env() 使用 HMAC-SHA256 签名验证
3. 认证协议不匹配：OAuth Token (RS256) 与 SDK 的 HMAC 认证方式不兼容
4. 历史记录：用户表示该 Token 格式之前可以正常使用，刷新后出现问题

───

Token Payload 示例

{
"iss": "longbridge",
"sub": "access_token",
"exp": 1783420934,
"iat": 1775644934,
"ak": "9931b97275f8ed93c4bc689b10ed2575",
"aid": 21331930,
"ac": "lb_papertrading",
"mid": 21291962,
"sid": "qJn9uVNDqElVfnBtFANdPA==",
"bl": 3,
"uh": 0,
"ik": "lb_papertrading_21331930"
}

───

猜测原因

1. 服务器端可能对 OAuth Token 的验证策略做了更新
2. 或需要使用 OAuth 的 client_id 通过 Config.from_oauth() 方式认证

───

需要的帮助

1. 确认 Python SDK 是否支持 OAuth Bearer Token 方式？
2. 如果支持，Config.from_oauth() 需要什么参数？
3. 或者需要重新生成什么格式的 Token 才能用于 SDK 的 HMAC 认证？

───

错误截图/Trace ID：afc70f472bcfaab577ab1fbec0dee3b4（仅供参考）

[Colbert-Ran]

我们定位下

[ohmanymoneygomyhome-creator]

之前可以用，access token 过期重置后就失败了

[Colbert-Ran]

目前有两种认证方式：以前的 Access Token 和新的 OAuth Token。这两种Token不能混用。可以任选其一。旧的认证方式仍然支持。

[Colbert-Ran]

从你的 Token Payload 示例来看，使用了旧的 Access Token ，使用 SDK 时不要使用 OAuth 认证方式。

[Colbert-Ran]

更简单的使用方式，推荐 AI + Longbridge CLI/MCP 来搭配。

[ohmanymoneygomyhome-creator]

没有混用，这是过期重置了一下。而且我都不知道OAuth Token在哪里生成，我用的是这里的

[ohmanymoneygomyhome-creator]

我用的openclaw，和长桥官方给的skills

[ohmanymoneygomyhome-creator]

官方改动了什么东西吗，昨天晚上短暂访问成功，现在访问又失败了

[ohmanymoneygomyhome-creator]

谢谢官方回复！

我们已经尝试使用 OAuth 方式进行认证，但在授权过程中遇到了错误：

OAuth authorization failed: internal_server_error

我们的操作步骤：

1. 使用 OAuthBuilder 构建授权 URL
2. 在浏览器中打开授权链接
3. 授权后回调到 http://localhost:34567/callback
4. 返回 internal_server_error

问题：

1. 开发者平台是否需要在应用程序中预先配置 redirect_uri？
2. 如果是，http://localhost:34567/callback 这个回调地址应该添加在哪个配置项？
3. 是否有其他方式可以解决这个问题？

感谢帮助！

[ohmanymoneygomyhome-creator]

Thank you for the reply!

We tried the OAuth authorization flow but encountered an error:

1. Authorization URL: https://openapi.longbridge.cn/oauth2/authorize
2. Callback: http://localhost:34567/callback
3. Error: internal_server_error

Questions:

1. Where in the developer portal can we configure the redirect_uri? We cannot find this setting.
2. You mentioned "AI + Longbridge CLI/MCP tools" - can you provide the documentation link?
3. Is there a way to get Access Token directly via App Key + App Secret (without OAuth browser authorization)?

Thanks!

[ohmanymoneygomyhome-creator]

服务器环境无法使用 - 需要帮助

我们在服务器环境（无浏览器）部署量化交易系统，遇到了认证问题：

已完成

1. 已获得 OAuth Access Token（有效期到 2026/7/7）
2. 已在服务器完成 OAuth 授权（通过手动在PC浏览器完成并保存 token）

问题

1. Bearer Token 调用 HTTP API（quote/candlesticks 等）全部返回 404
2. SDK 需要 OAuth 回调（需要在浏览器登录），服务器环境无法完成

我们的环境

• Windows Server / 无 GUI 环境
• 已安装 LongBridge CLI（native binary）
• Access Token: eyJhbGciOiJSUzI1NiIsImtpZCI6ImViNzNlNDQx...（已截断）

请问

1. 有没有适合服务器环境的 API 访问方式？（非 WebSocket，纯 HTTP 也可以）
2. HTTP API 的认证方式是什么？（Bearer token / HMAC / 其他）
3. LongBridge CLI 内部是怎么调用 API 的？能不能复用它的认证方式？
4. 我们的 OAuth App 显示 "application not authorized"，confirm 按钮禁用，是什么原因？

感谢！