群晖升级后 Typecho 后台 500 错误排查与解决记录

cover

背景

2026 年 7 月底，群晖 DSM 自动升级了系统。升级完成后发现博客后台打不开，直接返回 500 Server Error。前台页面访问正常，访客看不到任何异常，但后台无法进入就意味着无法写文章、无法管理评论。

于是开始了一下午的排查，记录整个过程，希望能帮到遇到同样问题的朋友。

现象

群晖升级后，Typecho 后台首页 admin/ 返回 500 错误
前台页面正常访问，文章、分类、评论都正常显示
其他后台页面（写文章、管理评论、插件设置等）也正常
只有后台首页（仪表盘） 报 500

前后台共用数据库和核心逻辑，前台正常说明数据库连接和环境都没问题，问题一定出在后台首页特有的代码上。

排查过程

1. 初步排查：PHP 扩展和配置

第一反应是 PHP 扩展可能有问题。群晖升级后 PHP 版本没变，还是 8.3，但环境配置可能有变化。

打开 Web Station 检查，mysqli 和 pdo_mysql 扩展都是开启状态，排除。

2. 尝试切换数据库驱动

修改 config.inc.php，把 Mysqli 换成 PdoMysql，结果报 class not found。说明 PDO 扩展虽然勾选了，但实际加载可能有问题。切回 Mysqli 继续排查。

3. 开启调试模式

在 config.inc.php 中添加：

define('__TYPECHO_DEBUG__', true);

神奇的事情发生了——后台首页正常打开了！关闭调试模式，又变回 500。

这说明代码本身没有问题，是 PHP 8.3 在生产环境下的某种机制（比如错误报告级别或输出缓冲处理方式）导致了崩溃。

4. 分段定位

在 admin/index.php 中插入 exit() 进行分段测试，发现每个测试点都能正常输出，说明代码执行流程完整，没有被中断。

问题很可能是：某个组件在完整输出时触发了致命错误，而提前终止程序时恰好绕过了它。

5. 缩小范围

通过逐步注释掉 index.php 中的不同代码块，终于锁定了两个"嫌疑人"：

\Widget\Contents\Post\Recent::alloc('pageSize=10')->to($posts);
\Widget\Comments\Recent::alloc('pageSize=10')->to($comments);

这是后台首页用来显示"最近发布的文章"和"最近得到的回复"的两个 Widget 组件。它们在 PHP 8.3 环境下存在兼容性问题，导致整个页面崩溃。

解决方案

由于这两个 Widget 组件的底层其实就是数据库查询，决定绕过它们，直接用原生 SQL 查询代替。

在 config.inc.php 中定义了两个辅助函数：

function getRecentPosts($limit = 10) {
    $db = \Typecho\Db::get();
    $query = $db->select('cid', 'title', 'slug', 'created')
        ->from('table.contents')
        ->where('type = ?', 'post')
        ->where('status = ?', 'publish')
        ->order('created', \Typecho\Db::SORT_DESC)
        ->limit($limit);
    return $db->fetchAll($query);
}

function getRecentComments($limit = 10) {
    $db = \Typecho\Db::get();
    $query = $db->select('coid', 'cid', 'author', 'text', 'created')
        ->from('table.comments')
        ->where('status = ?', 'approved')
        ->order('created', \Typecho\Db::SORT_DESC)
        ->limit($limit);
    return $db->fetchAll($query);
}

然后在 admin/index.php 中调用这两个函数，手动渲染列表。这样完全避开了 Widget 组件，问题顺利解决。