操作前紧急备份

在进行任何修复操作前，必须先对当前数据库和文件状态进行备份，防止修复失败导致数据彻底丢失。

# 1. 确认当前目录，防止误操作
pwd
# 2. 备份当前数据库（即使它是损坏的，也可能包含部分新数据）
mysqldump -u 数据库用户名 -p 数据库名 > backup_before_fix.sql
# 3. 备份网站文件
tar -czf website_backup.tar.gz /www/wwwroot/your_site

方案一：数据库还原实操

如果有升级前的完整备份，直接还原是最稳妥的方案。

1. 找到备份文件
检查服务器 `/data/` 目录、数据库管理工具快照或本地留存的 `.sql` 文件。

2. 执行还原命令
通过命令行还原数据库，注意确保数据库已存在：

# 创建数据库（如果不存在）
mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS 数据库名 CHARACTER SET utf8mb4;"
# 导入备份文件
mysql -u 数据库用户名 -p 数据库名 < backup_file.sql

3. 验证还原
登录 phpMyAdmin 检查表结构是否完整，表数量是否与升级前一致。

方案二：手动修复升级脚本

若没有备份，需定位失败的 SQL 语句手动执行。此操作风险较高，需仔细核对。

1. 定位脚本路径
pbootCMS 升级脚本通常位于升级包的 /upgrade/ 目录或根目录下的 `.sql` 文件中。若无独立目录，检查升级包中名为 update.sql 或带版本号的 SQL 文件。

2. 查看错误日志
检查 /runtime/log/ 下的日志或 PHP 错误日志，搜索关键词 SQLSTATE、Syntax error 或 Duplicate entry，定位报错的具体语句。

3. 对比与执行
使用文本对比工具（如 Beyond Compare）对比升级脚本与当前数据库结构。若脚本中包含 ALTER TABLE 失败，可先导出当前表结构：

# 在 MySQL 命令行中
SHOW CREATE TABLE 表名;

将导出结果与脚本中的建表语句对比，手动执行缺失或失败的语句。若遇到“字段已存在”错误，可跳过该语句；若遇到“键重复”，需检查是否部分执行导致。

清理缓存与安全验证

修复完成后，必须清理缓存使配置生效，但需谨慎操作。

# 1. 再次确认当前目录
pwd
# 确保输出包含网站根目录路径，严禁在 / 或其他系统目录下执行
# 2. 安全删除缓存（使用相对路径）
rm -rf ./runtime/*
# 3. 重建缓存权限
chown -R www:www ./runtime

验证步骤：

• 登录后台，检查“系统信息”版本号是否显示正确。
• 尝试发布一篇文章，确认数据库写入正常。
• 访问前台首页及列表页，检查是否有数据库报错提示。

常见风险与排查

• 数据库表前缀不一致：升级脚本默认前缀可能与实际不符（如 ay_ 与 pboot_），执行 SQL 前需用文本编辑器全局替换为实际前缀。
• 文件权限问题：/data/ 或 /runtime/ 目录权限不足导致脚本无法写入升级记录，确保权限为 755 或 777（视环境而定）。
• PHP 版本兼容性：新内核可能要求更高 PHP 版本，导致脚本解析失败，检查 php -v 是否符合升级包要求。
• 部分执行风险：手动执行 SQL 时切勿一次性执行整个文件，建议逐条或分块执行，每步确认后继续。

参考来源

• pbootCMS 官方网站：https://www.pbootcms.com/