Typecho 1.3 版本踩坑记：数据库迁移+版本兼容血泪复盘
最近给博客做版本更新，本以为是简单的「升级部分模块」，结果直接把网站干崩了——前后花了3个月修复（前两次尝试全失败），光数据库排查就耗了三四天，差点丢了几年的文章数据。复盘整个过程，核心问题出在 Typecho 1.3 版本的稳定性 和 PHP版本兼容，以及数据库迁移的细节上。
一、踩坑源头：Typecho 1.3 版本的「致命缺陷」
⚠️ 核心问题：Typecho 1.3 版本存在大量未修复的BUG，且与部分PHP版本（如PHP8.1+）兼容性极差，升级后直接导致网站崩溃，数据库结构与旧版本（1.2及以下）存在隐性差异。
我的博客原本运行在 Typecho 1.2 版本，适配PHP7.4，升级到1.3版本后：
- 前端页面空白、后台无法登录；
- 数据库表结构与旧版本不兼容，导入旧数据时频繁报错；
- 路由规则异常，文章链接全部404；
二、数据库迁移的「连环坑」（最耗时的环节）
网站崩溃后，唯一的救命稻草是原数据库备份，但导入过程中踩了N个坑，逐个复盘：
坑1：导出了「假的SQL文件」（HTML页面而非纯SQL）
- 现象：phpMyAdmin导出的文件开头是
<!doctype html>，导入时提示「SQL语法错误」。 - 原因：导出时误选了「添加HTML页面」或导出方式错误，下载的是页面源码而非数据库备份。
解决：
- 选中目标数据库 → 点击「导出」→ 选择「自定义 - 显示所有可用选项」；
- 仅勾选文章核心表：typecho_contents（文章）、typecho_metas（分类/标签）、typecho_relationships（关联关系）；
- 格式选择「SQL」，保存为文件，字符集选utf8mb4；
验证：用记事本打开，开头应为 -- phpMyAdmin SQL Dump。
坑2：导入时「未选中数据库」（#1046 - No database selected）
- 现象：执行SQL时提示「未选择数据库」，明明文件是对的却导入失败。
- 原因：直接在phpMyAdmin服务器级别执行SQL，未绑定目标数据库。
- 解决：先点击左侧目标数据库（如shuijuku），再进入「SQL」标签执行导入/语句。
坑3：重复导入导致表冲突（#1050 - Table already exists）
- 现象：提示「typecho_contents/typecho_comments 表已存在」。
- 原因：数据已导入成功，重复操作导致表结构冲突。
解决：停止导入！执行路由修复语句即可：
UPDATE `typecho_options` SET `value` = NULL WHERE `name` = 'routingTable'; DELETE FROM `typecho_options` WHERE `name` LIKE '%cache%';
坑4：只导入typecho_contents导致数据不完整
- 现象：文章能显示，但分类/标签全部丢失，无法按分类筛选。
- 原因：Typecho文章体系依赖「铁三角表」，缺一不可。
解决：必须同时导入3张表：
- typecho_contents：文章标题、正文、发布时间（核心）；
- typecho_metas：分类、标签数据；
- typecho_relationships：文章与分类/标签的关联关系。
三、最终修复成功的「核心步骤」
✅ 复盘总结：数据没丢就是最大的胜利！最终修复的关键步骤如下：
- 回退PHP版本：将PHP8.1降级为7.4（适配Typecho 1.3的稳定版本）；
- 重新导出旧数据库：仅勾选核心3张表，确保是纯SQL文件；
- 清空新数据库冲突表：删除已存在的typecho_contents/metas/relationships；
- 正确导入：选中目标数据库 → 导入SQL文件 → 执行路由修复；
- 验证：刷新首页，检查文章、分类、标签是否完整，链接是否404。
四、避坑建议（给Typecho用户的忠告）
- ❌ 不要盲目升级Typecho 1.3：除非确认PHP版本完全兼容（推荐PHP7.4），1.2版本反而更稳定；
- ✅ 数据库备份要「双保险」：导出后务必用记事本验证是否为纯SQL，避免下载HTML文件；
- ✅ 迁移只导核心表：无需导入评论/用户表（避免冲突），仅导contents/metas/relationships；
- ✅ 升级前先备份：包括网站源码+数据库，出问题可一键回滚；
- ✅ 版本不兼容时优先降级PHP：Typecho对PHP新版本的适配远不如降级老版本稳妥。
五、最后想说的话
折腾了一晚上数据库，差点丢了几年的文章数据，现在回想还是麻了。Typecho作为轻量级博客系统，优点是简洁，但版本兼容性和稳定性确实需要注意——尤其是1.3版本，堪称「坑王」。
如果你的博客也在用Typecho 1.3，建议要么降级到1.2.1，要么确认PHP版本适配；如果需要迁移数据库，一定要记住「选对数据库→导核心表→修复路由」这三步，能少走90%的弯路。
折腾的过程虽然痛苦，但解决问题后也算是积累了经验——至少以后再遇到数据库迁移，不会再犯同样的错了。