Bazzite 常见问题排查与修复方法
Bazzite 作为一款基于 Fedora Atomic 的 OCI 镜像，为 Steam Deck 和桌面电脑提供了出色的游戏体验。然而在使用过程中，用户可能会遇到各种技术问题。本手册将详细介绍 Bazzite 的常见问题及其解决方案，帮助您快速恢复系统功能。
系统启动与引导问题
EFI 路径修复
在最近的更新中，Bazzite 修复了 fwupd 的 EFI 路径问题。如果您遇到固件更新失败的情况，请检查 EFI 分区是否正确挂载。
解决方案： 运行以下命令修复 EFI 路径：
ujust fix-efi-path
GRUB 配置目录缺失
某些情况下，运行 grub2-switch-to-blscfg 时可能出现目录缺失错误。
解决方案： 系统已通过更新自动修复此问题。如果仍然遇到此错误，请确保系统已更新至最新版本。
游戏模式问题排查
帧率控制异常
Bazzite 为 Gamescope 提供了修补后的 Mesa，确保正确的帧率控制。如果发现帧率不稳定：
- 检查 Gamescope 日志：
ujust post-gamescope-logs - 验证 GPU 驱动程序状态
- 重启 Gamescope 会话
音频问题处理
蓝牙设备导致系统无法挂起： 这是已知问题，已在最新版本中修复。
解决方案： 更新系统并重启：
rpm-ostree upgrade && systemctl reboot
硬件兼容性问题
NVIDIA 显卡问题
对于使用 NVIDIA 专有驱动的用户，Bazzite 提供了专门的 NVIDIA 版本。常见问题包括：
- 旧版 NVIDIA 硬件支持： 系统会自动检测并应用相应配置
- NVK 驱动问题： 注意 Mesa 的 NVIDIA GPU 开源选项 NVK 目前仍容易出现错误
掌机设备特殊配置
不同品牌的掌机设备需要特定的设置调整：
- ROG Ally X： 在连接底座时优先使用 HDMI 音频输出
- Steam Deck： 自动应用 SteamOS 的内核参数
- 其他手持设备： 参考 Handheld Wiki 获取详细配置指南
软件安装与更新问题
Python 包安装错误
由于移除了 pip 安装的包并使用新制作的 rpm 包，解决了在分层某些包时出现的 Python 错误。
解决方案： 使用系统提供的 rpm 包而非 pip 安装：
ujust install-required-packages
更新大小优化
Bazzite 引入了镜像重分块功能，将更新大小降低了 85%。如果更新过程中遇到问题：
- 检查网络连接
- 使用
rpm-ostree status查看当前系统状态 - 如有需要，可回滚到上一版本
系统回滚与恢复
更新导致的问题
如果更新后出现问题，Bazzite 支持轻松回滚到之前的版本。
解决方案：
rpm-ostree rollback && systemctl reboot
网络与连接问题
下载速度优化
Bazzite 默认使用 Google 的 BBR TCP 拥塞控制算法，提供更好的网络性能。
安全启动配置
安全启动密钥注册
对于启用安全启动的用户，需要注册自定义密钥：
ujust enroll-secure-boot-key
注意： 如果提示输入密码，请输入 universalblue。
常见错误代码解析
错误代码：E93fa00
描述： 运行 grub2-switch-to-blscfg 时目录缺失错误 状态： 已在最新版本中修复
错误代码：Ac457f0
描述： fwupd 的 EFI 路径问题 状态： 已修复
性能优化建议
内存管理
- Bazzite 默认使用 ZRAM（4GB）和 LZ4 压缩算法
- 支持 32GB RAM 改装，自动应用双倍最大 VRAM
电源管理
- 支持低风险降压
- 电池最大充电量限制服务
- 显示超频支持
