三种上手机的方式
开发者工具右上角有三个相关按钮:
- 预览:生成二维码,你用微信扫,手机上立刻跑最新代码。日常改完就扫,最常用。
- 真机调试:手机跑的同时,电脑上能看到手机端的控制台报错。手机上出问题时用。
- 上传 → 体验版:上传后在小程序后台设为体验版,添加「体验成员」,他们不用扫开发码也能打开。给朋友和客户试用时用。
手机上白屏的三个常见原因
1. 网络请求被拦:小程序只允许请求后台配置过的「合法域名」。用云开发不需要配;一旦引入了第三方接口就会撞上。我们 CLAUDE.md 里那条红线就是防这个。
2. 手机微信版本太旧,不支持某个新 API。让 AI 用兼容写法或做能力检测。
3. 模拟器里勾了「不校验合法域名」,所以电脑上正常、手机上不正常。这是最常见的「我这里好的」。
交给 AI 的正确姿势:
「真机调试控制台报错:(原话)。手机微信版本 8.0.x,机型 xxx。请修复,只改相关文件,并说明为什么模拟器里没有报错。」自测 · 学完检查一下
想真正动手做题、记进度、攒连胜?到互动课里练。
你想让 5 个朋友帮忙试用一周,反馈问题。该用哪种方式?
答案:上传体验版,把他们加为体验成员
体验版就是为「一批固定的人长期试用」设计的。预览码有效期短、每次改动都要重发;装开发者工具对非开发者太重;提交审核是给所有用户上线的动作,还没到那步。
手机上打开是白屏,模拟器却正常。你想看到手机端到底报了什么错,该用?
答案:真机调试
只有真机调试能把手机端的控制台输出回传到电脑。预览和体验版只让你看到现象,模拟器则根本不是手机。
真机调试显示「request:fail url not in domain list」。这说明什么,该怎么办?
答案:代码里请求了未配置的外部域名;要么去后台配合法域名,要么按红线改回云开发
这条报错的原话已经把原因说完了:域名不在列表里。它正是 CLAUDE.md 红线「不使用需要合法域名的外部请求」要防的。让 AI 说明为什么模拟器没报错,你就会发现是勾了「不校验」。
判断:朋友用体验版反馈「点添加没反应」,你在模拟器里试了正常,可以回复他「我这边正常,可能是你手机问题」。
答案:错
第 7 课和本课都在讲同一件事:别人的手机上不行就是真问题。正确做法是问机型和微信版本,自己用真机调试复现,把报错原话交给 AI。