Skip to content

mtproto/qqnt/bridge: 修媒体连接 CONNECTION_NOT_INITED、upload 贴纸发不到 QQNT、assign 后不刷新 - #19

Open
std-external wants to merge 3 commits into
std-microblock:mainfrom
std-external:fix/media-conn-layer-and-sticker-send
Open

std-external wants to merge 3 commits into
std-microblock:mainfrom
std-external:fix/media-conn-layer-and-sticker-send

Conversation

@std-external

Copy link
Copy Markdown
Contributor

修三个问题:媒体连接 auth.importAuthorization 返回 CONNECTION_NOT_INITED、upload 型贴纸发不到 QQNT、表情包 assign 之后客户端不刷新。三处各自独立,按问题的成因/改法拆成三个 commit。

来源:Koishi On Topic 群里 Anillc 的实测报告(成因分析由他给出,已在 commit 里加 Co-authored-by)。

1. 媒体连接 auth.importAuthorization: 400 CONNECTION_NOT_INITED

现象:主连接正常,sticker set 列表能加载;贴纸图片、缩略图、其它媒体全部加载失败。日志里 auth.importAuthorization 和 crossgram.getFileUrl 交替刷 400 CONNECTION_NOT_INITED,重连、重启客户端都无效。

成因

  • 服务端的闸门在 packages/mtproto/src/session/server-session.ts:连接上 _apiLayer === null 时,任何 RPC 都回 CONNECTION_NOT_INITED,目的是让客户端重发带 invokeWithLayer(initConnection(...)) 的版本。
  • 媒体连接(auth.exportAuthorization 之后新建的 socket)在服务端是全新的 ServerSession,_apiLayer 从 null 开始,而它的第一个 RPC 往往就是 auth.importAuthorization。
  • 层只按 auth key 记(service.ts 的 _authApiLayers),新 DH 出来的 key 没有任何历史层可继承;_adoptStoredAuthKey 那条读回 apiLayer 的路径只覆盖「复用已存 key」。
  • 普通的 400 客户端会重发,auth.importAuthorization 不会:Telegram Desktop 的 CONNECTION_NOT_INITED 重发在 onErrorDefault 里,而 import 自己的 importFail 对非临时错误(400)返回 true,默认处理被截断。一次失败就把整条媒体连接冻死,之后的 upload.getFile / crossgram.getFileUrl 全是同一条错误。

改法:协商出的层同时按客户端指纹(api_id + 设备型号 + 版本,都来自 initConnection)记一份。

  • ServerSession 把 clientInfo 交给 _onApiLayer / _getApiLayer 回调;
  • Mtproto 维护 _clientApiLayers,_lookupApiLayer() 先按 auth key 找、再按指纹找;协商成功时顺手把层发给同客户端的兄弟连接(_rememberApiLayer / _applyKnownApiLayer)。

未知客户端仍然走原来的闸门,协议语义不变;响应 writer map 仍按客户端真实层走。

回归测试

  • packages/mtproto/src/session/media-connection-layer.test.ts(新):裸 import 在无层时仍被拒(闸门保留);同一条 import 包了 wrapper 时先取层再执行;同客户端已在别的连接协商过层时,裸 import 直接通过。
  • packages/mtproto/src/service.test.ts:同客户端的兄弟连接拿到层、不同版本客户端不受影响、_applyKnownApiLayer 能按指纹补层。

2. messages.sendMedia: 400 STICKER_SEND_UNAVAILABLE(QQNT)

成因:QQNT 能力声明是 stickers: { native: true, upload: false },第三方 sticker provider(QQ 里没有原生引用的贴纸)解析出来的是 type: 'upload' 计划,bridge 的 _assertSendableMedia(packages/bridge/src/dialogs.ts)在进平台发送之前就抛 STICKER_SEND_UNAVAILABLE,所以本地/第三方贴纸能显示、发不出去。

改法:平台侧补降级路径(packages/platform-crossgram/src/index.ts)—— upload 计划不再抛错,按 static/animated 当图片、video 当文件,走已有的媒体上传链路发出去;能力改为 stickers: { native: true, upload: true }。代价是对方收到的是一张图、不再是可收藏的 QQ 表情,这点写进了注释。

测试:platform.test.ts 新增两条 —— 静态 upload 计划变成 image part(并确认降级发生在平台侧、贴纸字节此刻还没被读),视频 upload 计划变成 webm 文件。

3. 表情包 assign 之后 TG 不刷新(第三个 bug)

现象:面板里 assign 一个表情包,TG 里看不到;强制重启、清 cache 都无效,退出重新登录才出来——数据确实写进去了,只是运行期没有任何 update 让客户端本地缓存失效。

成因:setStickerPackAssignment()(packages/bridge/src/sticker-dashboard.ts)只写 mtproto_sticker_set_install 行,全仓库从来没推送过 sticker 相关 update。客户端自己的 messages.getAllStickers / messages.getStickerSet 都带 hash,命中就回 NotModified,所以不问就永远是旧的那份。

改法:归属变化后,对目标账号所有 auth key 推两条 update(packages/bridge/src/index.ts):

  • updateNewStickerSet,带完整 messages.stickerSet —— Telegram Desktop 的 newSetReceived() 会当场把 set 装进列表、替换文档;硬性要求是 set 带 installed_date、不带 archived,否则整条 update 被丢弃。TDLib 也是立刻落库。
  • updateStickerSets(flags 0),让客户端重新拉一遍列表(messages.getAllStickers)。

StickerRpc 新增 makeStickerSetUpdate(),把 getStickerSet 的 set 投影抽成 _projectStickerSet() 复用,保证推出去的 set 和客户端自己问到的完全一致。投影失败只记日志,不让已经落库的归属变更报错。

测试:sticker-rpc.test.ts 覆盖已关联 pack 的 updateNewStickerSet 负载(installed_date 有值、archived 为空、文档与 emoji pack 齐全),以及 pack/provider 不存在时返回 undefined。

验证

npx vitest run \
  packages/mtproto/src/service.test.ts \
  packages/mtproto/src/session/media-connection-layer.test.ts \
  packages/mtproto/src/session/server-session.test.ts \
  packages/bridge/src/sticker-rpc.test.ts \
  packages/bridge/src/sticker-dashboard.test.ts \
  packages/bridge/src/management-service.test.ts \
  packages/bridge/src/media-send.test.ts \
  packages/platform-crossgram/src/platform.test.ts \
  packages/platform-crossgram/src/sticker-provider.test.ts

全部通过(mtproto 67 / bridge 与 platform 侧 249)。tsc -p tsconfig.test.json 在改动文件上没有报错(仓库里 webui client 的 react 依赖缺失是环境既有问题)。没跑 test:e2e:mtproto(需要先 yarn build),如需我可以补。

std-external and others added 3 commits November 17, 2026 22:10
客户端只在「它认为这个 DC 还没 init」时才把 RPC 包进
invokeWithLayer(initConnection(...))。媒体连接(auth.exportAuthorization
之后新建的 socket + 新的 auth key)上,第一个 RPC 往往就是
auth.importAuthorization,而这条连接在服务端是全新的 ServerSession,
_apiLayer 仍为 null。

服务端原先只按 auth key 记层,新 key 没有历史层可继承,于是回
CONNECTION_NOT_INITED。普通 RPC 客户端会重发一遍,auth.importAuthorization
不会(Telegram Desktop 只对 5xx / flood 走默认错误处理,400 交给
importFail 直接终结),于是一次就把整条媒体连接冻住:贴纸图片、
缩略图和其它媒体全都下不动,日志里 import 和 getFileUrl 交替刷同一条错。

改成把协商出的层同时按客户端指纹(api_id + 设备型号 + 版本)记一份:
新连接、刚握完手的连接都能直接继承同一客户端已经用过的层,媒体连接不必
再等一轮 initConnection;协商成功时也顺手把层发给同客户端的兄弟连接。
未知客户端仍然走原来的闸门,协议语义不变。

回归测试:
- media-connection-layer.test.ts:裸 import 在无层时仍被拒(闸门保留)、
  包了 wrapper 时先取层再执行、同客户端已协商过层时裸 import 直接通过。
- service.test.ts:同客户端兄弟连接拿到层、不同版本客户端不受影响、
  _applyKnownApiLayer 能按指纹补层。

Co-authored-by: Anillc <void@anil.lc>
QQNT 平台能力只声明了 stickers.native,第三方 provider(QQ 里没有原生
引用的贴纸)解析出来的是 type: "upload" 计划,bridge 的 _assertSendableMedia
据此直接抛 400 STICKER_SEND_UNAVAILABLE,消息根本没走到平台发送阶段:
贴纸能显示、发不出去,只有 QQ 自己那套 native 贴纸能发。

平台侧补上降级路径:upload 计划不再抛错,按静态/动图当图片、视频贴纸
当文件,走已有的媒体上传链路发出去;能力改为 stickers.upload = true。
代价是对方收到的是一张图而不是可收藏的 QQ 表情,这一点写进注释。

测试:platform.test.ts 新增两条——静态 upload 计划变成 image part(且降级
发生在平台侧、字节此刻还没被读),视频 upload 计划变成 webm 文件。

Co-authored-by: Anillc <void@anil.lc>
面板里 assign 一个表情包只写了 mtproto_sticker_set_install 行,没有发任何
update。客户端本地那份 set 和列表都不会失效:重启、清 cache 都不行,只有
重新登录(重新拉 messages.getAllStickers + messages.getStickerSet)才看得到
新归属。

补两条推送:带完整 set 的 updateNewStickerSet(Telegram Desktop 的
newSetReceived 会当场把 set 装进列表并替换文档;它要求 set 带 installed_date
且没有 archived,否则整条 update 被丢弃),以及 updateStickerSets 让客户端
重新拉一遍列表。投影失败只记日志,不让已经落库的归属变更报错。

StickerRpc 新增 makeStickerSetUpdate(),把 getStickerSet 的 set 投影抽成
_projectStickerSet 复用,保证推出去的 set 和客户端自己问到的完全一致。

测试:sticker-rpc.test.ts 覆盖已关联 pack 的 updateNewStickerSet 负载
(含 installed_date、无 archived、文档和 emoji pack),以及 pack/provider
不存在时返回空。

Co-authored-by: Anillc <void@anil.lc>
@std-external

Copy link
Copy Markdown
Contributor Author

CI 全绿:Unit tests and typecheck(ubuntu / windows)、WebUI browser e2e、Compose deployment e2e 都通过。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant