昨儿半夜捣鼓这玩意儿，差点把键盘给砸了。妈的当时刚部署完娜美源代码，满心欢喜点开浏览器，结果蹦出来一堆鬼画符。搓了把脸寻思着，干脆把踩过的坑全捋一遍给大伙儿避雷。
第一关就栽在环境配置上
跟着官方文档吭哧吭哧装依赖包，pip install 敲得键盘冒火星子。结果运行命令立马扑街！满屏红字哐哐往上滚，定睛一看特么缺了八个依赖。气得我直拍大腿：文档里写的依赖版本跟实际需要的差两代！麻溜打开终端重新敲：
pip install flask==2.1.0 mysqlclient==2.1.1 —— 版本号必须手动锁死，不然准报错！
数据库连环坑警告
接着搞数据库迁移，python * migrate 刚跑完就傻眼。后台疯狂报主键冲突，查了仨钟头才发现坑点：
- 数据库要是原来有测试数据，必须手动清空连表头带渣滓全删光
- 迁移前先执行 python * makemigrations 生成临时文件
- 本地mysql密码带特殊字符？赶紧用单引号裹起来 不然分分钟认证失败
完事儿重启服务时又卡在端口占用。摸出命令行 netstat -ano 查PID，任务管理器里把残留进程全宰了才清净。
前端的玄学闪退
最邪门的是前端。页面刚加载出来挺正常，点两下按钮直接白屏！控制台里躺着一行 Uncaught TypeError，顺着线索扒拉JS代码，发现某个组件初始化要传个空数组。原版demo根本没提这茬，老子硬是加了行 defaultProps: {dataList: []} 才救活。后来翻issues才发现早有老哥骂过这破设计。
给新手的保命总结
- 别信文档版本号！装包前先去GitHub翻commit记录
- 数据库操作前 备份三遍 别问我为啥知道
- 白屏先查浏览器控制台，错误信息比算命准
- 社区issue区当救命稻草，关键词搜错报信息一抓一个准
搞到凌晨三点终于跑通，瘫在椅子上灌冰可乐。这玩意儿就像拼乐高，图纸漏印三页纸，零件还特么少一袋。按着官方教程铁定栽坑里，记着这几条能少熬两宿夜。
