安装飞书 Bridge提示"凭证交换过程发生异常"

[macoli]

[Bowl42]

感谢反馈 🙏

这条「凭证交换过程发生异常」来自飞书 Bridge App（openilink-app-lark）OAuth 回调里的兜底异常分支：换凭证流程中任一步失败（App 服务器连不上 Hub、Hub 返回了非 JSON、本地存储写入失败等）都会落到这句通用文案，真实原因之前只打在 App 的服务端日志里，安装页上看不到，所以你只能看到一句话、无从排查。

已提交修复 openilink/openilink-app-lark#1：异常时把底层原因作为 detail 一并返回，安装页/响应里能直接看到具体出错原因。

麻烦升级到含该修复的 lark App 版本后重试，把新的报错（带 detail 字段的那段）贴上来，就能定位你这边的具体故障了。在那之前可以先自查几点：

1. 飞书 App 服务器能否正常访问你的 Hub 地址（HUB_URL，注意内网/防火墙/HTTPS 证书）；
2. setup 页面填的 App ID / App Secret 是否正确、对应应用是否已创建版本并发布；
3. 权限是否按引导页的 JSON 批量开通；
4. 若是自建部署，看一眼 lark App 容器日志里 [oauth] 凭证交换异常: 后面的具体报错。