# 2026-10-14 · 真机探针实测：H2-01 在真机侧被证实，手机卡加载根因锁定

## 取证方式

- 包：`probe-wyszz-env-v1`（只打印环境事实，不渲染）
- 工具：微信开发者工具 Stable 2.02.2608080「**真机调试**」
- 真机：**HUAWEI-ALN-AL10**，HarmonyOS/Android 31，微信 **8.0.78**，基础库 **3.17.4 [1656]**，4G
- 用户自行扫码，Console 原文由用户复制

## 真机 Console 原文（节选，逐字）

```
[wxapplib]] [BaseLibVersion] WAGame.js: 3.17.4 (2026.10.10 14:39:14)
[wxapplib]] 是否开启数据管道batch请求= false {"platform":"android","SDKVersion":"3.17.4","isGame":true,...,"IS_IOS":false,"IS_ANDROID":true}
[LifeCycle] emit execEntryFile for WAGameSubContext.js
[PROBE-BEGIN]
[PROBE] typeof requestAnimationFrame = function
[PROBE] typeof cancelAnimationFrame = function
[PROBE] typeof setTimeout = function
[PROBE] typeof globalThis = object
[PROBE] typeof window = undefined
[PROBE] typeof self = undefined
[PROBE] typeof GameGlobal = object
[PROBE] typeof wx = object
[PROBE] typeof console = object
[PROBE] GameGlobal.requestAnimationFrame = function
[PROBE] globalThis.requestAnimationFrame = function
[PROBE] window.requestAnimationFrame = <无 window>
[PROBE] self.requestAnimationFrame = <无 self>
[PROBE] wx.requestAnimationFrame = undefined
[PROBE] rAF 是否可调用 = 是，已请求一帧
[PROBE] typeof wx.createCanvas = function
[PROBE] wx.createCanvas() 调用 = 返回对象 ok
[PROBE] typeof canvas.addEventListener = undefined
[PROBE] typeof canvas.removeEventListener = undefined
[PROBE] typeof canvas.getContext = function
[PROBE] typeof canvas.requestAnimationFrame = undefined
[PROBE] typeof wx.getSystemInfoSync = function
[PROBE] wx.getSystemInfoSync() 键数 = 36
[PROBE] wx.getSystemInfoSync().windowWidth = 388
[PROBE] typeof wx.getWindowInfo = function
[PROBE] typeof wx.getMenuButtonBoundingClientRect = function
[PROBE] typeof wx.getStorageSync = function
[PROBE] typeof wx.onError = function
[PROBE-END]
[PROBE] rAF 回调已触发 ts=1791961250643 typeof=number
```

## 工具模拟器同一探针的输出（对照）

```
[PROBE] typeof window = object
[PROBE] typeof self = object
[PROBE] typeof canvas.addEventListener = function        ← 模拟器有
[PROBE] typeof canvas.removeEventListener = function     ← 模拟器有
[PROBE] wx.getSystemInfoSync() 键数 = 39
[PROBE] rAF 回调已触发 ts=825.600000238419 typeof=number
```

## 逐项对照表

| 探针项 | 工具模拟器 | **真机** | 判定 |
|---|---|---|---|
| `typeof canvas.addEventListener` | `function` | **`undefined`** | ★ **H2-01 真机侧成立** |
| `typeof canvas.removeEventListener` | `function` | **`undefined`** | ★ 同上 |
| `typeof requestAnimationFrame` | `function` | `function` | 真机正常 ⇒ **新 P0（rAF）不成立于真机** |
| `GameGlobal.requestAnimationFrame` | `function` | `function` | 同上 |
| `typeof window` / `self` | `object` / `object` | **`undefined` / `undefined`** | 真机无这两个全局 |
| `wx.getSystemInfoSync()` 键数 | 39 | 36 | 非空对象 ⇒ **H2-03 真机侧不成立** |
| `wx.getSystemInfoSync().windowWidth` | 388 | 388 | 正常 |
| `canvas.getContext` | `function` | `function` | 正常 |
| `canvas.requestAnimationFrame` | `undefined` | `undefined` | 真机画布也没有该方法 |
| `wx.getWindowInfo` / `getMenuButtonBoundingClientRect` / `getStorageSync` / `onError` | 均有 | 均有 | 正常 |
| rAF 回调时间戳 | `825.6`（number） | `1791961250643`（number） | 真机 rAF 回调参数是数值 |

## 结论

1. **手机卡加载的根因 = H2-01。**
   three r186 在 `new THREE.WebGLRenderer({ canvas })` 构造期**无条件**调用
   `canvas.addEventListener('webglcontextlost' / 'webglcontextrestored', …)`
   （`three.module.js:16440-16442`；同处 `:16437` 反而守卫了 `setAttribute`）。
   真机 `canvas` 没有这两个方法 ⇒ 抛 `TypeError` ⇒ 渲染器建不出来 ⇒ 黑屏卡加载。
2. **这解释了「模拟器能跑、真机不能」**：模拟器的画布由工具模拟，有 `addEventListener`；真机没有。
3. **H2-01 的准确定性（第三次修正，以此为准）**：
   - 工具（开发者工具模拟器）侧：**不成立**（画布有该方法，`[renderer]` 能打出）
   - **真机侧：成立**（探针实测 `undefined`）
   ⇒ 结论：**H2-01 是真实的真机级缺陷，必须修。** 评审侧此前「从已证实 P0 降级」的表述**错误**，须一并更正。
4. **新 P0（`requestAnimationFrame is not a function`）不成立于真机**：
   真机 `requestAnimationFrame` 与 `GameGlobal.requestAnimationFrame` 均为 `function`，回调正常触发且时间戳为数值。
   该报错**只在开发者工具的「游客模式」下出现**（工具特有的受限模拟环境）。
5. **H2-03（`sys()` 得到 NaN）真机侧不成立**：真机 `getSystemInfoSync()` 返回 36 键、`windowWidth=388`，非空对象。
6. **新增待评估项**：真机 **没有 `window` / `self` 全局**（模拟器有）。
   我方 `src/wechat/main.ts:18-19` 会自行设置 `g.self` / `g.window`，但 three r186 内部亦有
   `self` / `window` 相关分支，需评估在真机上是否走不同路径。**未验证。**

## 附：包体积数字出现分歧（待复核）

| 来源 | 数字 |
|---|---|
| 我们的 `MANIFEST.json` / H2-15 结论 | 615.9 KiB（630686 B） |
| 工具「二维码预览」对话框 | **代码包 1652 KB** |
| 工具「真机调试」面板 | 流量 **118 KB**，压缩节省 **342 KB** |

三者口径不同（未压缩 / 含基础库 / 压缩后传输量），**H2-15 的「15.04% of 4 MiB」结论需复核**。未定论。

## 修复动作

已产出 **包 J · 真机画布垫片**：
前置一段**只含画布垫片**的 IIFE（包裹 `wx.createCanvas`，给每次返回的画布补
`addEventListener` / `removeEventListener` / `dispatchEvent` 空实现），
**不含 rAF 垫片**（真机 rAF 正常，加了反而有遮蔽全局的风险）。
`dist/wechat/game.js` sha256 `089feda0833b5380a3442cd863889edf66e5e87ef2153b6b33ad0ab8d955b0b4`
→ 垫片后 sha256 `4bd01a96f0cf35b23cdfd004f54f2850f7b3d15db285c59c39ea35c198b2d166`。
