开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 9 条记录。
项目全部项目智慧乐活圈 lehuoquan乐活圈 OA 考勤 lehuoquan-oaMagicEngine 悦居魔法引擎如影随形 TraceMate悦居集团数字化 · 统一后台悦居智能 CRM悦居可视通话 yueju-call悦居存储管家 StorageMate悦居反诈专家 AntiFraud悦居智能NVR小红花 LittleBlossom悦居统计后台 DashboardFileBreeze悦居护眼卫士 EyeGuard宠物小程序贝芽妈(lovely-child)悦居智能官网悦居存储管家 AndroidSmartHome 安卓控制端适老智家 AgeHome悦居 AI 日历轻风快传官网 FileBreeze中航天业竞价小程序绿荫网球中心官网绿荫网球小程序青年公社小程序青年公社官网中羊坊村官网 Zhongyangfang自动化脚本集 automation我的减肥日记 WeightLoss画山别墅的旅行家 Travel画山别墅里的国学世界 GuoXue冰雪冬奥张山营延庆骑行网 YanqingBike延庆徒步网 GoHike智能门锁 SmartLock排队仿真 QueueSimulation悦居智能小程序 yueju-miniprogram智能会议室预约 meeting乡村文旅 VillageHub减肥日记小程序日常运维国学小程序 guoxue3D智慧城市 SmartCityLiveRobot 数字人应梦寺爬山smart_home_chat花间向导 SmartGuideWorkBuddy 指标看板T5AI 聊天机器人悦居AI相册(相册管家)
2026-11-10
发版前多了步 md5 对拍,救回 490 条产品规格
发版前把服务器上前后端每个文件的 md5 算成清单,跟本地逐一比对——而不是直接 rsync --delete。对出两个文件只存在于服务器、从未进过 Git:一份供应商价格表数据源(已补全过规格)、一张规格标签对照表(多 11 个键);旁边还躺着两个 .bak 和四个一次性修复脚本。
直接部署会怎样:用本地版覆盖后,490 条产品的结构化规格(显指 / 色温 / 尺寸 / 灯珠)静默退回旧版,官网规格区大面积空掉;65 条产品的「配件」标签全没;11 个标签消失、界面直接显示英文键名。而部署日志、健康检查、首页 200 全都会显示成功。
处置:线上版本取回入库(逐条确认仅线上多 490 条规格、少 9 条表格说明行);四个脚本原样存档并标「路径写死指向线上库,不要跑」,它们恰好解释了那批规格怎么补出来的。
两条教训:① 数据源与标签白名单只能改仓库,直接改线上会在下次部署时静默还原;② rsync --delete 前一步固定是 md5 对拍,不是可选项——健康检查只能告诉你「进程活着」,告诉不了你「数据还在」。
2026-10-20
踩坑:跨库搬产品图不能按 id 搬,要按「供应商+型号+名称」反查
跨库搬产品图时把
product_images.product_id直接搬过去,会把图挂到隔壁产品上。- 本地库与线上库的
products.id并不一一对应:同一批供应商在不同时间导入,id 段整体偏移(这次差 7 条),4283 条里有 3190 条的 id 对不上。 - 正确做法:按「供应商 + 型号 + 名称」的交集反查目标库的行;同名多行按产品 id 顺序一一配对。只按名称会命中重复,只按型号会命中同款四色,交集才唯一。
- 动手前先跑映射预演,并核对一件事:
原有覆盖是否被新覆盖完全包含。这次原有覆盖 369 个产品、新覆盖 668 个、原有而新缺失 0 个,才落库。 - 第二个坑:
product_images.created_at是 NOT NULL 且没有默认值,手写 INSERT 必须显式补时间戳 —— 否则抛 IntegrityError,而delete已经在同一事务里执行过,看着很像「数据已经没了」(实际会回滚)。 - 第三个坑:先传了图片文件、后补数据库记录,中间跑了一次审查脚本,被判成「233 条没有产品图」—— 审查脚本查的是
product_images表,不是文件系统。文件和记录要一起到位再跑审查。
- 本地库与线上库的
2026-10-10
构建排障两例:一行「25.0.2」和它掩盖的错误;以及构建成功≠产物正确
- flutter build apk 1 秒失败只输出「25.0.2」:Flutter 优先用 Studio 自带 JDK 25,Gradle 8.14 不认;改 --jdk-dir 到 17.0.7。
- permission_handler_android 自带 AGP 9.0.1、硬编码 compileSdk 37,与 Gradle 8.14/36 代差;已摘掉。
- 构建成功不等于产物正确:图标脚本按自身目录拼路径,5 张图标写错位置,只有 API 24/25 真机暴露;签名缺配置时静默回退 debug。
2026-10-09
一条超长字段,能把整个页面打挂
- 现象:供应商列表页整页挂,产品库按价格排序也整页挂,看着像前端写坏,实为数据问题。
- 根因:SQLite 文本字段无长度上限,接口出参契约限 64 字,写入无感、查询才炸;一家 21 个品牌拼进「主营品类」达 80 多字。
- 修法三层:导入按上限截断并统计截断条数;上限值直接取自出参契约;冒烟测试加超长值断言,确保列表仍返回 200。
- 教训:数据侧超长会表现成前端崩溃,排查先拿一条真实数据过接口;此后导入前先跑字段长度体检。
解析「跑通了」不等于「解析对了」:三个静默错误
- 脚本一路打印成功、条数也对,但有三处静默错误,结果都看起来合理。
- ① 三张表被判无表头,19 条真产品没进:闸门要求表头含价格类词,默认词表缺「产品价格」,补入后解决。
- ② 插座凭空多出同价「单火」版:合并单元格使零火/单火两列读出同值;加闸「拆出版本与主价相同即不是两件货」,两表从 51+32 收敛到 35+25。
- ③ 分类被关键词抢走:床归成窗帘电机、中控屏归成音箱、音响线当成音箱,重排分类优先级修正。
- 教训:每次解析后必须回原表逐格核对,并看类目分布是否符合常识。
部署脚本用 rsync --delete,把线上的启动脚本删了
- 现象:一次例行部署后站点直接 502。
- 根因:rsync --delete 全量同步把线上手工放置、未进仓库的启动脚本删掉,进程管理器重启找不到入口。
- 脚本最后一步打印「部署完成」,健康检查拿到 502 仍照常打印成功。
- 修法:启动脚本纳入版本库;健康检查改硬判据,返回内容必须含 ok,否则非零码退出并提示看日志。
- 结论:全量同步与服务器手工文件天生冲突;打印成功不等于真成功。
2026-10-08
自动断言也可能是假断言:用 0 验证 0
- 断言「在谈项目金额合计等于 0」恒成立,实为验证 0 == 0,实现写错也会通过。
- 改为比对接口真实返回的「在谈金额」字段才有意义。
- 截图脚本以 URL 是否以 /dashboard 结尾判登录成功,而登录失败跳 /login?redirect=/dashboard 也命中,密码错误被静默当成功。
- 改为严格比对完整地址,并额外等一个仅登录后存在的元素。
- 结论:断言先问「实现写错时它会不会失败」,会失败的才叫断言。
折线图看着挺正常,数据点却全飘在顶部
- 现象:月度趋势折线峰谷正确,但代表各月的圆点全落在图表顶部。
- 根因:折线用 SVG、数据点用 HTML 绝对定位,SVG 的 y 轴向下、CSS 的 bottom 向上,整条曲线被垂直翻转。
- 修法:bottom = 100 − (y / 高度) × 100。
- 另坑:SVG 呈现属性不解析 CSS 变量,stroke 写 var(--brand) 会静默失效,必须用 :style 绑定。
- 结论:跨两套渲染体系拼图形,坐标方向与颜色解析规则都要各验一遍。
还没签约的项目,被算成了「亏损 4.9 万」
- 现象:在谈项目的明细行显示合同额 ¥0、利润 ¥-49,173 且标红,看着像已经亏了。
- 根因:统一公式「合同额 − 总成本」只对已成交项目成立,代码漏了这个前提。
- 修法:仅已成交算利润,未签约的利润与利润率留空显示短横线,成本照常显示,表头注明未签约项目不计利润。
- 补一条断言专守此回归。
- 教训:同一公式在汇总与逐行两种用法下前提可能不同,汇总时全是成交项目所以看不出来。