问题记录与反思
一、问题复盘
- 正式版图片不显示问题：小程序开发版、体验版中图片展示正常，但发布至正式版后图片完全不显示。经排查，核心原因是后台返回的图片
src为//xxx.png格式（缺失 HTTP/HTTPS 协议），测试环境对协议缺失的校验较宽松，而正式版强制要求 HTTPS 协议，导致图片加载失败。 - 姓名脱敏逻辑遗漏问题：页面重构时，我仅聚焦新需求的实现，未注意到原有页面中 “姓名首字脱敏” 的前端处理逻辑，重构后直接展示用户完整姓名，违背了业务对用户信息脱敏的合规要求。
二、问题根源深挖
（一）技术细节与环境认知不足（图片问题）
- 对小程序不同运行环境的差异认知不全面：仅关注功能逻辑的实现，忽略了开发版 / 体验版与正式版在协议校验、权限管控等方面的严格程度差异；
- 缺乏通用的 URL 规范化处理意识：未考虑到后台返回数据可能存在的格式不规范问题，未提前做协议补全、格式校验等兜底处理，过度依赖测试环境的验证结果。
（二）需求梳理与逻辑衔接缺失（脱敏问题）
- 重构前的需求梳理不完整：将页面重构等同于 “新功能开发”，仅关注新增需求，未主动梳理原有页面的所有业务逻辑（尤其是 “姓名脱敏” 这类无显性交互、但涉及合规的隐性逻辑）；
- 缺乏历史逻辑核对环节：开发过程中未对照旧版代码 / 需求文档核对核心逻辑，也未主动与产品、测试确认 “需保留的历史规则”，仅凭主观记忆判断开发范围。
（三）共性问题：流程意识与细节敬畏心不足
无论是图片协议问题还是脱敏逻辑遗漏，本质都是 “开发流程不闭环”“细节把控不到位”：测试环节仅覆盖核心功能，未针对 “环境兼容性”“历史功能回归” 做专项验证；同时存在 “重新功能、轻旧逻辑”“重功能实现、轻边界细节” 的片面思维。
三、具体改进措施
1. 技术层面：补齐兜底与校验机制
- 新增通用工具函数：封装
formatImageUrl方法，对所有图片src进行校验，若缺失协议则自动补全为 HTTPS，确保 URL 格式规范； - 梳理隐性合规清单：整理项目中用户信息脱敏、数据格式校验、隐私权限等隐性合规规则，形成《前端合规逻辑清单》，作为开发必查项。
2. 流程层面：完善重构与验证规范
- 重构前：输出《历史功能核对清单》，逐一确认需保留的旧逻辑，由产品、测试核对签字后再启动开发，杜绝 “漏项”；
- 测试前：主动补充 “环境兼容性测试用例”（开发版 / 体验版 / 正式版）、“历史功能回归用例”，确保测试覆盖完整；
- 发布前：新增 “正式版预验证” 环节，在正式版发布后先小范围验证核心功能、兼容性，确认无问题后再全量开放。
3. 个人层面：强化细节与责任意识
- 摒弃 “重新轻旧” 思维：开发中主动对照旧版代码、需求文档，不凭记忆判断功能范围，对不确定的逻辑及时与产品、原开发人员确认；
- 学习环境差异知识：梳理小程序不同环境的运行规则、校验差异，形成笔记并定期复盘，提升环境兼容性认知；
- 主动复盘总结：每次开发完成后，自检是否覆盖 “功能 + 合规 + 兼容性”，并将本次问题的教训同步至团队，避免团队成员踩坑。