碍之声 开发日志

比赛与院校名称不在此公开，仅作技术复盘。日志中不含任何真实用户数据与联系信息。

• ✅ 三端客户端（PC 网页 / Android APP / 微信小程序）+ SpringBoot & MySQL 后端
• ✅ 手语 AI 识别模型（YOLO3 + Keras）
• ✅ 域名备案 —— 联调期最大的一道坎
• ✅ 资质、备案、接口约定三件事，贯穿了整个开发周期

---

2024/9

• ✅ 需求调研：听障人群的实际使用场景、同类产品调研
• ✅ 政策与资料收集，明确内容合规边界
• ✅ 模块划分：home / mine / rehab / society / study / feature / job
• 计划先做 PC 端，后端与小程序后置

---

2024 秋

• ✅ PC 端基本页面：资讯、学习、康复训练
• ✅ 手语识别模型选型，跑通 YOLO3 + Keras 的识别链路
• 发现导航栏使用不统一：部分页面用原生导航栏，部分用自定义导航栏，先记账后还
• 登录注册页只写了壳子，没有接后端；数据库也还没设计

---

2025 春

• ✅ 后端：SpringBoot + MySQL，补齐基础接口（静态资源 + 动态数据）
• ✅ 数据库设计落地
• ✅ 前后端分离，接口约定先行 —— 三端同时开工，接口对不齐就要反复改，后来固定先写接口约定再动手
• 手语 AI 接入期间：接口限流、密钥过期轮着来，中途换过两次方案，最后做了降级兜底，识别不到就走兜底提示而不是白屏

---

2025/6/7

APP 端真机死活请求不到后端静态资源

• 明明有 SSL 证书、没有跨域，浏览器能访问、小程序体验版也能访问后端图片
• 但 APP 端真机无论如何请求不到后端静态资源
• 排查结论：真机上的 localhost / 127.0.0.1 指的是手机自己，必须换成后端机器的局域网 IP
• 临时方案：APP 版静态资源全部打包进本地；小程序版继续用线上静态资源

小程序端的两道墙

• ✅ 没有企业主体资质，发不了正式版，只能走体验版
• 小程序体验版连不上后端 /api，初步推断是域名没备案被拦截，开始备案流程

---

2025/6/9

uni.request fail {"errno": 600001,
  "errMsg": "request:fail net::ERR_CONNECTION_RESET"}
  at pages/login/login.vue:50

• 一度怀疑是 SSL 证书问题（证书明明是有的），方向差点走偏

---

2025/6/10

昨天调试了一整天，把所有问题排查一遍，最终确定是域名备案问题，不是证书问题。

当天盘点的状态：

1. 前端只实现了基本页面，实际功能有限，「课程」「频道」还是外部链接，体验版里也打不开
2. 后端基本接口可用，能提供静态资源和动态数据
3. 小程序体验版：只有静态资源能访问，动态数据接口连不上
4. APP 端：连静态资源都请求不到，全靠打包进本地
5. 登录能拿到 openid，拿不到头像、昵称
6. 法务侧的资质、资源申请都还没下来

---

2025/6/16

• 前端访问后端的 URL 散落在各处，改成统一管理，以后换环境好改
• （经验：这种重构应该在写第一个页面时就做，而不是联调时补）

---

2025/6/19

• ✅ 备案下来了，确认之前就是域名备案的问题
• 小程序端动态数据接口恢复访问，三端联调终于跑通

---

收尾

• ✅ 三端对齐、真机联调、模型接入
• 资质类问题（小程序主体、残障相关许可、备案）全部是"代码写完才发现做不了"的类型

回头看，这个项目真正的难点不在代码：真机调试、资质限制、接口联调——这三件事任何团队都会再遇到。
代码量是比赛要的，踩坑记录是自己的。