Clara BBS 升级只需两步先完整覆盖上传新版本文件保留config/、uploads/、content/plugins/等目录再进后台「系统工具 → 数据库升级」执行一次增量 DDL整个过程幂等可重复执行不需要 Composer、不需要命令行、不用清缓存保存即生效。为什么升级这么简单无框架带来的红利结论Clara BBS 没有 Composer 依赖、没有编译缓存、没有构建产物所以升级本质上就是换代码 补表结构两件事。很多 PHP 论坛升级麻烦是因为要跑composer install、清runtime/缓存、重启队列进程。Clara BBS 是单模板 运行时插件钩子的轻量架构PHP 7.4-8.5 MySQL 5.7 直接跑插件目录content/plugins里的钩子运行时加载、保存即生效因此覆盖文件后新功能、新钩子会立刻可用不存在存量缓存还指着老类名的问题。第一步覆盖文件怎么覆盖才不丢数据结论只覆盖程序代码目录绝不覆盖用户数据目录升级前先备份数据库和uploads/。具体做法先备份。导出 MySQL 数据库宝塔面板 → 数据库 → 备份或 mysqldump再把uploads/目录打包下载一份。这一步是唯一不能省的。解压新版本包到本地确认目录结构和线上一致。上传覆盖。用 FTP/SFTP 或宝塔文件管理器把新版本文件上传到站点根目录提示覆盖时选择全部覆盖。重点保留这几处config/配置文件存着数据库账号密码和站点密钥、uploads/用户上传的图片附件、content/plugins/第三方插件、以及你自己改过样式的模板文件。多数打包工具会把这几项包含在内覆盖前先看清包里有没有同名目录有的话升级时排除掉。权限检查。覆盖后确认uploads/仍是可写权限否则上传功能会直接报目录不可写。覆盖完成后前台应该已经能打开。如果此时出现数据表字段不存在之类的报错属正常现象——代码是新的数据库还是旧的下一步补上就好。第二步数据库升级一键补齐新增字段结论进后台「系统工具 → 数据库升级」点一次执行即可它跑的是增量 DDL幂等设计重复点也不会出问题。这个入口解决的就是新版本加了新表新列的问题版本迭代时通常会新增货币字段、GEO 相关表、登录审计日志表、勋章条件列等等。数据库升级工具会对比当前表结构与目标结构把缺的列和表自动补齐执行期间不影响已有数据也不会删你的东西。几点注意执行一次就够不用反复点万一中途报错修好环境后重跑已执行的语句会跳过。升级完顺手看一眼后台各功能页能否正常打开尤其是插件页和管理日志。如果开了 PWA覆盖文件后建议让用户强刷一次页面或后台清一下缓存避免旧 service worker 缓存了老静态资源。跨多个大版本跳级升级建议逐个版本按顺序升不要一步跨太远。升级后必做的三项体检结论升级不是点完按钮就结束花五分钟做三项检查能挡掉大部分升级后出问题。一查核心链路发帖、回帖、上传图片、私信各跑一遍确认 CSRF token、会话、上传白名单都正常。如果发帖提示页面已过期请刷新后重试通常是 CSRF 校验没过——新版编辑器内置了自动重试还不行就检查后台「基本设置」里的站点地址是否带了https://和主域名避免 www 与裸域混用丢会话。二查上传图片传不上去先看后台「系统设置 → 上传」的两组字段——允许的扩展名管图片、附件允许的扩展名管附件是两个独立配置再看 PHP 的upload_max_filesize/post_max_size是否够大宝塔默认 2M建议调到 30M。三查 GEO 开关升级后到「系统设置 → GEO 优化」确认各项开关状态符合预期顺便看一眼 AI 爬虫访问监控表确认豆包、DeepSeek 这些爬虫还正常来访LLMS 文本和问答聚合页都能正常生成。写在最后Clara BBS 升级的正确姿势就是备份 → 覆盖代码保留 config、uploads、plugins→ 后台执行一次数据库升级 → 三分钟体检。没有命令行、没有依赖安装、没有缓存清理这正是无框架轻量设计的收益。真正需要你操心的只有升级前那份备份。