上礼拜刷论坛看到有人安利重建最新版多牛逼，心一痒就把旧项目给卸了。结果装新版的时候差点没被坑死，今天必须把踩的雷记下来！
一、查版本号就栽跟头
官网首页写得明明白白最新是v2.8.3，我兴冲冲复制安装命令。装完运行rebuild --version却显示v2.7.1！气得我当场捶键盘，折腾二十分钟才发现文档底下有行小字：“部分区域镜像延迟更新”...
小编温馨提醒：本站只提供游戏介绍，下载游戏推荐89游戏，89游戏提供真人恋爱/绅士游戏/3A单机游戏大全，点我立即前往》》》绅士游戏下载专区
- 避坑操作：别信首页！去Git仓看release页签，确认更新时间
- 血泪结论：官方文档比菜市场标价牌还不靠谱
二、依赖包暗藏杀机
按教程用npm install rebuild-core装依赖，直接报错说python版本不对。明明旧版用python3.6好好的，新版非要3.9+。更恶心的是报错提示“请升级python”，还藏着个坑——必须卸载所有python旧版！
清完环境准备再战，又卡在C++编译工具链。这回直接报几百行红字，找半天发现要装vs_BuildTools那坨3G的玩意儿。
- 避坑操作：装之前先开管理员权限跑rebuild doctor
- 血泪结论：Windows用户建议备好咖啡和降压药
三、配置文件大变活人
好不容易跑起来，配置文件直接给我罢工。老版*里auto_scale: true在新版里居然要改成scaling_mode: dynamic！更绝的是日志路径配置，原先log_dir: /var现在必须拆成file_*和file_*两段...
改完配置启动服务，数据库又连不上。翻新版文档才看见小字警告：“不再支持MySQL5.7”！连夜升级数据库差点搞崩测试环境。
- 避坑操作：旧版配置文件直接删掉！用rebuild init生成新模板
- 血泪结论：开发者绝对把写文档的时间拿去撸猫了
四、网传秘方全是砒霜
卡在权限报错，搜到某中文论坛说“chmod -R 777 就行”。照着操作后服务倒是起来了，第二天服务器就被挖矿脚本攻占。重装系统时气得想把手剁了。
官方论坛扒了三页才发现正解：新版必须用installer自动处理权限，手动改权限会破坏安全策略。
- 避坑操作：看见“777”就跑！官方文档搜索error code
- 血泪结论：搜索引擎前五页都是坑货指南
现在总算把v2.8.3跑稳当了，总结新版最大忠告：卸掉旧版先备份，翻文档要带放大镜，报错截图存三份。这玩意儿升次级比我老家修路还费劲！
