OpenBot v1.1.0 正式版为什么会让部分旧接口返回 404?
OpenBot v1.1.0 正式发布,从 v1.0.x 升级涉及不可逆数据库迁移、两个 PostgreSQL 角色与新版 API 路径。
旧客户端遇到接口返回 404 时,首先要区分已退役路径与仍保留的登录、回调或健康检查路径。接口版本切换也伴随数据库迁移。

稳定版的升级边界
OpenBot v1.1.0 是稳定通道的正式发布,官方发布说明沿用此前候选版的内容。从 v1.0.x 升级时,数据库和接口要按 v1.1.0 的要求评估。已经跟进候选版的环境,其实际数据库状态取决于先前已经执行的迁移。
第一次启动就是数据库的切换点
新服务启动时自动运行 PostgreSQL 迁移,部分旧表的数据移至新表,旧表会保留但停止写入。旧表还在并不能提供完整的回退状态。正式升级的回滚依据是升级前的数据库备份,切回旧容器或程序版本不能撤销数据库迁移。

应用账号和连接池的权限条件
升级后的查询分别使用 openbot_app 和 openbot_system。两个角色不能登录、不能有超级用户权限,也不能绕过行级安全。迁移会把角色授予 OpenBot 的登录账号。如果该账号没有创建角色的权限且管理员也没事先建立所需角色,迁移会停止,显示要执行的 SQL,并且不会改动数据库。
服务在启动和运行期间都会检查实际的查询角色。外置 PostgreSQL 连接池需要透传启动参数 role。官方说明中,Compose 和 openbot-bundle 已包含这项设置。
新版接口规范与保留路径
旧客户端中已退役的路径会返回 404。新版 REST 的路径写在 api/openapi.yaml 中,WebSocket 通道由 api/asyncapi.yaml 定义。组织资源放在 /api/v2/organizations/{organizationId}/ 下,逐路径放行的网关需要覆盖 /api/v2/ 并允许 WebSocket 升级请求。
仍有路径留在新版前缀之外,例如登录、SSO 与 SCIM 所用的 /api/auth、事件 Webhook 的 /api/events,以及 /health。旧的 /api/channels/events 已退役,不能因为名字近似将它当作保留的 Webhook。
JDK 17移除Nashorn后,Java怎么执行JS脚本?
2026-11-17 11:59:41
如何用Node.js区分Claude Microsoft 365连接器与其他故障事件
2026-11-15 01:54:56
怎么在Node.js官网查找API文档和学习资源
2026-11-13 14:06:37
Node.js官网无法访问的常见原因及本地网络排查
2026-11-12 21:22:04
Node.js官网主要功能板块介绍:下载、文档与API查询
2026-11-12 19:53:15
