开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 14 条记录。
项目全部项目智慧乐活圈 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-10-20
中转通道被旧连接误删导致 37 帧静默丢包
- 问题:服务端中转是否落盘/残留。结论:不落盘,纯 WS 内存转发,
relayChannels在 relayEnd/断连即释放;唯一落盘是取件码 DropStore(TTL 24h、5min 扫),实测目录为空。 - 顺手查出真 bug:
cleanupByDevice不判断设备是否已被新连接接管就删 relay 通道。现场 13:58 tao-mac→华为:通道 04 秒建立、14 秒接收端断开被清、16~20 秒发送方又推 37 帧全部Unknown channel,而代码只console.warn不回帧 → 客户端进度条照走、接收端缺片。 - 修复:服务端改为按
deviceId重绑 from/to + 30s 宽限期(期间重连自动恢复),Unknown channel 回relayError(CHANNEL_LOST)(同 requestId 只报一次),新增relayAlive探活回复relayAccept(recovered);客户端RelayTransfer区分暂时/致命,分片边界awaitChannelReady挂起等恢复,超时 30s 才失败。 - 验证:服务端 jest 52/52(新增 relay-rebind 5 项)、客户端 flutter test 152/152(新增 4 项);生产
tool/relay_rebind_live_check.js实测断开前 3/3、重连后 20/20 帧,日志出现🔁 Rebound channel。 - 坑与部署:服务端 src 长期「线上比仓库新」(bindings 修复只改了服务器),本次先回写仓库再改再部署;
docker compose up -d --build后 health OK / WS 101,顺手把已提交未上线的/api/errors限流+读鉴权一并带上线。提交7b4063f已推 Gitee。
- 问题:服务端中转是否落盘/残留。结论:不落盘,纯 WS 内存转发,
2026-10-17
华为→iPhone 传视频失败:分片写盘没关文件句柄
- 华为→iPhone 传视频失败:接收端 pipe 完没 flush/close 就返回 200,缓冲未落盘,合并读到空分片,SHA-256 校验 422。
- 三条写盘路径全包 finally flush + close;中转合并前对账已收分片数 vs 声明数,缺片报缺哪几片,4xx/5xx 响应体 ≤500B 带进异常。
- 新增「2 分片并发上传」单测,不 await close 必坏可稳定复现;客户端测试 88 项全通过。
- 遗留「视频播放失败」是播放器解码该流失败,与传输无关。
2026-10-14
传输到一半打开 WiFi 就停了:断网 / 切网现在会自动续传
- 传到一半开 WiFi 就停:重试 1 次+退避 1 秒约 2 秒窗口,远短于换网 5–15 秒;续传数据存了却没有恢复入口。
- 新增「等待网络」状态(占住并发位、最长 3 分钟),恢复后自动续传并重新解析对端地址;分片超时 30→15 秒。
- 网络类异常走等恢复、业务类走退避,两套计数器;顺带修状态文本只转入参小写、并发分片重复上报开始。
- 客户端 86 项全过(新增 8 项覆盖网络恢复);涉及传输层,两端须同版本。
iOS 相册「既不授权也不弹框」的根因:权限库的编译宏没打开
- iOS 相册既不授权也不弹框:权限库的相册读写编译宏没在工程里打开,请求落到未知权限分支直接拒绝。
- 依赖安装钩子补两个宏并重跑安装;新增统一权限网关:查状态→说用途→弹框→被拒给去设置。
- 有限访问视为通过;接收预检从「全是图片」放宽为「图片+视频」,原来收视频压根不申请权限。
- 修掉保存路径里已删依赖的调用;静态分析 0 错、测试 78 项全过,真机安装成功。
2026-10-12
电脑端接收小程序文件:落盘位置、临时文件残留与「全程无提示」
- 电脑端接收文件修三处:落盘改到下载文件夹根,不再多套产品子目录;分片暂存移到应用支持目录,合并后连空暂存根一并清理。
- 局域网直传不走信令,原先全程无提示;主界面加接收提示:发送中、已接收 N 个文件并给「打开文件夹」、失败显示原因。
- 顺带修进度估算:分片变小后仍按旧假设反推会提前跑满,改为采纳发送方清单里的分片数。
小程序错误上报链路打通:写接口加配额、读接口加鉴权
- 小程序错误上报链路打通:写接口加专用限流 + 条目级配额,实测 30 次请求 × 100 条即可冲空环形缓冲。
- 读接口此前完全无鉴权,一次请求就能爬走完整调用栈、设备标识与任务号,本轮补上。
- 超配额返回成功但标记已丢弃,避免客户端整批回队重试放大压力;健康检查暴露已丢弃条数。
- 客户端补齐两个错误码,与小程序侧同码同义,两侧文件头互标「必须同步」。
2026-10-11
服务端镜像构建上下文缺忽略清单,环境变量文件与备份目录被打进镜像
- 服务端镜像构建缺忽略清单(该文件从未入库),环境变量文件(含签名密钥与后台口令)与备份目录被打进镜像层。
- 危害等同凭据泄露,换变量值后旧镜像层仍留旧值。
- 补上忽略清单,环境变量、备份、临时文件一律不进构建上下文。
- 中转接口同期加独立限流与单文件/单会话/文件数/有效期上限,落盘名由服务端生成防路径穿越。
- 此后交付前增加构建上下文内容检查。
2026-10-06
修复多文件传输进度条反复回落导致的「单文件闪烁」
- 现象:多文件传输进度条涨一段就归零,看着像在重复传同一个文件。
- 根因:进度 = 已收分片 / 总分片,文件合并后其分片从已收表移除,分子骤降,顺序发送时每个文件都走一遍涨满归零。
- 修复:以已落盘文件累计字节为基座(只增不减),加当前文件已收分片比例,夹在 [0, 总字节];同名文件按出现次序匹配清单尺寸。
- 顺带把任务卡副标题最前面明写「N 个文件」,避免长文件名截断后看成单文件。新增真实分片上传回归,50/50 通过。
根治「选多个文件发送、对方只收到一个」:共享文件 ID 撞号 + 同名覆盖
- 现象:手机选 5 张图发电脑,两端都报成功,磁盘只有 1 个文件。
- 根因:文件 ID 用毫秒时间戳,多选同步连发全落在同一毫秒,映射表后写覆盖前写;传输历史里 5 条的名称、大小、ID 全相同且等于任务号。
- 修复:ID 改微秒时间戳 + 自增序号并循环校验不冲突;接收端同名自动追加序号、绝不覆盖;合并落盘返回实际路径,完成判定改为已合并数达到清单长度。
- 顺带修:原先用待收分片表为空判整批完成,顺序发送时首文件合并完就提前报成。新增 11 例回归,49/49 通过。
修复「对端设备地址不可用」:网络变化丢端口 + 自动降级中转 + 错误码体系
- 根因:网络变化回调里用不带端口的构造方式重建设备信息,本地服务端口被清空,上报地址只剩 IP,发送方前置校验直接判死。
- 三层防护:重建时保留端口;服务端发现接收方地址缺端口改走中转;客户端把直接判死改为「直连→中转」降级,并给发送入口补异常兜底,避免任务永久停在传输中占并发位。
- 错误码体系落地:失败提示带编号(如 E1005),14 个失败分支统一带码,补齐 WebRTC / 蓝牙码位,修掉重试时旧错误文案残留。
- 验证:静态分析 0 error,客户端 38/38(新增 5 例)、服务端 32/32(新增 2 例),三台设备上报端口全部非空。
根治长时间挂机后设备失联:信令半开自愈 + 无限重连 + 定时健康巡检
- 现象:桌面端长挂后进程活着、界面显示在线,但各端互相看不到,只能重启恢复。
- 根因:TCP 半开时收不到关闭也收不到错误回调,连接状态仍显示已连接;两处缺陷是重连有次数上限、心跳只发不等回。
- 改法:心跳升级往返探测,3 个周期无服务端消息即判死重建;移除重连上限,退避最长 30 秒永不放弃;局域网发现广播 30 秒未成功即重建;另加每 60 秒健康巡检。
- 用只握手不回数据的假信令服务器验证:第 75 秒准确触发重连;回归 21/21 通过。
2026-10-04
错误上报链路真正打通:固定 API 基地址 + 运行期全局异常兜底
- 错误上报此前从未成功:地址由信令地址派生,信令迁 wss 后拼出的地址带 wss 前缀,HTTP 客户端不支持,异常被吞。
- 改为固定 API 基地址常量,所有 REST 调用只认这一处,不再派生。
- 日志初始化改幂等可更新:启动早期只传上报地址,初始化前记录暂存内存(上限 200 条),完成后统一补写补报。
- 入口包进 runZonedGuarded,加 FlutterError.onError 与 PlatformDispatcher.onError 兜底,统一映射崩溃码 9999。
- 验证:analyze 0 error,test 21/21,服务端 /api/errors 读写正常。
P1/P2 全部修复:完整性校验、文件策略、合规页与 i18n、单测补齐
- 修完 8 项 P1 + 7 项 P2(6593827,31 文件)。
- P1:隐私协议内置、中英切换、错误上报落库、SHA-256 校验、10GB 阻断、Redis 降级、单测 21+30。
- P2:删重复 _checkUpdate、并发常量单一来源、relay 改实例字段、CI 与 systemd。
- 坑:flutter test 需 pumpAndSettle;intl 需升 ^0.20.2。
- 验证:analyze 0 error、test 21/21、jest 30/30、构建 29.8s。
2026-10-02
上线前安全加固:修复全部 7 项 P0 阻断问题
- 上线就绪审查修完 7 项 P0(819cbdc,25 文件 +1054/-298)。
- 覆盖路径穿越、配对令牌 + CORS、缺 JWT_SECRET 拒启、限流 + WS 校验、强制签名、版本号统一、删死分支。
- 坑:集成测试 open 后才注册监听,connected 握手丢失成静默超时;SessionHandler 未 close 致进程不退,17s→1.8s。
- 验证:analyze 0 error、Windows 构建 56.9s、服务端 25/25。P0-2 涉协议,两端需同步升级。