Hyprland 下腾讯会议屏幕共享排障与 Flatpak 回退#

现象与适用范围#

在一台运行 Hyprland 的 Arch Linux 台式机上，腾讯会议 Linux 客户端出现了三类现象：无法发起屏幕共享、无法观看他人的共享画面，以及部分视频区域黑屏。本文记录的是一次针对 Flatpak 版 com.tencent.wemeet 的回退实践，不应把它理解为所有 Wayland、显卡或腾讯会议版本的通用结论。

最终在本文机器上可复现的结果是：回退到指定构建后可以发起共享；观看共享在另一台设备可用、在本台台式机仍不可用。因此“回退可恢复发起共享”是观察结果，“它能解决所有共享问题”不是本文的结论。

环境与前提#

测试环境为 Linux 7.1.8-zen1-3-zen、Hyprland 0.56.2，使用系统级 Flatpak 安装。屏幕共享依赖 PipeWire 与桌面门户链路；在动手改版本前，先确认它们已安装并在当前会话中正常工作：

flatpak info com.tencent.wemeet
systemctl --user --no-pager status xdg-desktop-portal pipewire

如果应用是以用户级方式安装，下面所有未显式带 --user 的 Flatpak 命令都应改为用户级操作；不要混用两套安装位置。

排查过程#

最初尝试过强制 X11 环境变量和 AUR 的 wemeet-bin 包，但在这台机器上都没有恢复可用的屏幕共享。这个结果只能说明它们不适用于该环境，并不能证明方案本身无效。

随后比较 Flatpak 构建历史，发现旧构建在本机可发起共享。Flatpak 支持使用 remote-info --log 查看远端提交，并用 update --commit 部署指定提交；降级系统级安装需要管理员权限。官方的 Flatpak 文档也建议在回退后使用 mask 防止应用自动回到分支最新版本。Flatpak 的回退与 mask 说明

回退到已验证构建#

先查看历史。提交哈希会随应用、分支和镜像保留策略变化，以下哈希仅对应本文当时的测试，不要在未知环境中直接照抄：

flatpak remote-info --log flathub com.tencent.wemeet

本文验证过的构建为 3.26.10.400，提交以 ffadf7cb 开头。若日志中能找到完整提交，再执行回退：

sudo flatpak update \
  --commit=ffadf7cb1afbe5c8831b179a4608c8e76376c7f8048f918052500575600351ef \
  com.tencent.wemeet
sudo flatpak mask com.tencent.wemeet

mask 只阻止后续更新或安装匹配的 ref，不会替代回退命令本身。需要恢复更新时执行：

sudo flatpak mask --remove com.tencent.wemeet
sudo flatpak update com.tencent.wemeet

如果远端找不到所需对象或返回 404，先确认 remote 地址与元数据，而不是反复执行降级命令：

flatpak remotes --show-details
sudo flatpak remote-modify flathub \
  --url=https://mirrors.sjtug.sjtu.edu.cn/flathub
flatpak update --appstream flathub

镜像是否保留对应历史提交由镜像端决定；切换镜像会影响今后的更新来源，排障完成后应按自己的网络与信任要求决定是否恢复官方 Flathub 地址。

验证与已知边界#

启动应用后，先用一个可控的测试会议验证发起共享、选择器能否出现和远端是否能看到画面：

flatpak run com.tencent.wemeet
flatpak info com.tencent.wemeet

预期 flatpak info 显示的版本与提交应和回退目标一致。本文的两台设备结果如下：

两台设备的差异尚未完成最小化对照，可能涉及显卡驱动、门户后端或系统组件组合，不能据此认定单一根因。下一次排查应记录 xdg-desktop-portal 后端、GPU 驱动、PipeWire 版本与 Flatpak 权限，而不是只比较客户端版本。

备份与迁移#

可以从本地 Flatpak 仓库导出单文件 bundle；它不包含运行时和 AppStream 数据，目标设备仍可能需要从远端取得依赖。官方也将仓库或 USB 离线分发视为比单文件 bundle 更完整的选择。Flatpak 单文件 bundle 文档

sudo flatpak build-bundle /var/lib/flatpak/repo \
  com.tencent.wemeet.flatpak com.tencent.wemeet stable \
  --runtime-repo=https://dl.flathub.org/repo/flathub.flatpakrepo

flatpak install --bundle com.tencent.wemeet.flatpak

如需迁移应用数据，先退出应用再备份；其中可能含登录状态，应将压缩包视为敏感文件，避免上传到公共位置：

tar -czf wemeet-data.tar.gz ~/.var/app/com.tencent.wemeet/

总结#

这次排障的可迁移经验是：把“客户端回退”“门户链路可用”“远端能看到画面”作为独立验证点。回退可以是定位版本回归的临时手段，但应锁定构建、记录完整提交和环境差异，并在后续新版本中重新验证后再解除锁定。