修复Foliate 3更新后无法打开任何书籍的问题

开发者阿泽

2026-4-17

我最近也踩过这个一模一样的坑，不管是APT还是Snap版本的Foliate，更新后都没法打开电子书，在Ubuntu 22.04和24.04上都出现了这个报错。试了几个方法终于搞定了，分享给你：

重置Snap版本的Foliate（优先推荐）
报错里的bwrap: setting up uid map: Permission denied是Snap容器常见的权限问题，大概率是本地缓存或权限配置损坏导致的，直接重置就能解决：
```
sudo snap remove foliate
rm -rf ~/snap/foliate
sudo snap install foliate
```
卸载后一定要删掉用户目录下的Snap数据文件夹，不然重装后旧问题还会残留。
清理GTK配置文件的无效项
虽然报错里的Unknown key gtk-modules警告不是直接崩溃的原因，但它可能干扰程序启动流程，我们可以处理掉：
打开GTK 4的配置文件：
```
nano ~/.config/gtk-4.0/settings.ini
```
找到带有gtk-modules的那一行，要么在行首加#把它注释掉，要么直接删除这一行，按Ctrl+O保存、Ctrl+X退出编辑器即可。
修复APT版本的Foliate
如果你用的是APT安装的版本也出问题，大概率是旧配置和新版本冲突了，完全卸载后重装就能解决：
```
sudo apt purge foliate
rm -rf ~/.config/com.github.johnfactotum.Foliate
sudo apt install foliate
```
purge会彻底删除程序和系统层面的配置，再手动删掉用户目录下的配置文件夹，确保是干净的全新安装。
极端情况：重启系统或检查UID
如果上面的方法都没用，先重启一下系统试试——有时候系统权限缓存会出奇怪的问题。如果还是不行，检查你的用户UID：
```
id -u
```
正常普通用户的UID是1000，如果你的UID是特殊值，可能需要调整Snap的权限配置，但这个情况很少见，优先试前面的方法。