DietPi系统从Bullseye升级到Bookworm的故障排查与解决

问题背景

在将DietPi系统从Debian Bullseye版本升级到Bookworm版本的过程中，用户遇到了一个与MariaDB配置相关的错误。该错误导致系统升级过程中断，并显示以下关键错误信息：

update-alternatives: error: alternative path /etc/mysql/mariadb.cnf doesn't exist
dpkg: error processing package mariadb-common (--configure):
 installed mariadb-common package post-installation script subprocess returned error exit status 2

错误分析

这个错误表明在升级过程中，系统尝试配置mariadb-common软件包时，无法找到预期的配置文件/etc/mysql/mariadb.cnf。该文件本应由mariadb-common软件包提供，但在系统中缺失。

进一步检查发现，虽然dpkg数据库记录显示该文件应属于mariadb-common软件包，但实际上文件系统中并不存在该文件：

ls -l /etc/mysql/mariadb.cnf → 文件不存在
dpkg -S /etc/mysql/mariadb.cnf → 显示文件应属于mariadb-common软件包

解决方案

要解决这个问题，我们需要手动恢复缺失的MariaDB配置文件。以下是详细步骤：

1. 下载mariadb-common软件包：

   cd /tmp
   apt download mariadb-common
   

2. 强制安装并恢复缺失的配置文件：

   dpkg -i --force-depends,confmiss mariadb-common*.deb
   

3. 验证文件已恢复：

   ls -l /etc/mysql/mariadb.cnf
   

4. 完成系统升级：

   apt upgrade
   bash <(curl -sSf 'https://raw.githubusercontent.com/MichaIng/DietPi/master/.meta/dietpi-bookworm-upgrade')
   

可能遇到的额外问题

在执行升级过程中，用户还遇到了GitHub CLI仓库签名过期的问题。这会导致APT更新失败，错误信息如下：

The following signatures were invalid: EXPKEYSIG 23F3D4EA75716059 GitHub CLI <[e-mail]>

解决方法是通过以下命令更新GitHub CLI的GPG密钥：

curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
sudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg

升级验证

成功解决上述问题后，系统可以正常升级到Bookworm版本。升级完成后，可以通过以下命令验证：

echo $G_DISTRO_NAME → 应显示"bookworm"
uname -a → 应显示基于Debian 6.1.x的新内核版本

总结

DietPi系统从Bullseye升级到Bookworm时可能遇到的主要问题包括：

1. MariaDB配置文件缺失导致的dpkg配置错误
2. 第三方仓库(如GitHub CLI)签名过期导致的APT更新失败

通过手动恢复缺失的配置文件和更新过期的GPG密钥，可以顺利完成系统升级。建议在进行重大版本升级前，始终备份重要数据，并确保所有第三方仓库的签名密钥是最新的。