# 2026-10-14 · 新 P0：`requestAnimationFrame is not a function`（实测，工具侧已复现）

## 报错原文（用户实测，微信开发者工具 Stable 2.02.2608080）

```
WAGame.js:1 TypeError: MiniProgramError
requestAnimationFrame is not a function
    at Object.raf (game.js)
    at $a.start (game.js)
    at <require(game.js)>
    at p (WAGameSubContext.js:1)
    at Object.runWith (WAGameSubContext.js:1)
    at P (WAGameSubContext.js:1)
    at game.js:1
(env: Windows,mp,2.02.2608080; lib: 3.17.4)
```

工具内部再报一次（URL 指向模拟器内）
`TypeError: requestAnimationFrame is not a function at Object.raf (http://127.0.0.1:25862/game/game.js:4299:132909) … (env: Windows,mp,2.02.2608080; lib: 3.17.4)`

## 对应源码

`src/wechat/main.ts:49`
```ts
raf: (cb) => { requestAnimationFrame(cb); },   // ← 裸全局
```
`src/app/app.ts:94` `this.host.raf(ts => this.frame(ts));` —— **回调依赖时间戳参数**
`src/app/app.ts:115 / 132` 同样调用（onShow 恢复、resize 后）

## 官方文档 vs 实测

| | 内容 |
|---|---|
| 官方文档 | [requestAnimationFrame](https://developers.weixin.qq.com/minigame/dev/api/render/frame/requestAnimationFrame.html)（2026-10-14）：`number requestAnimationFrame(function callback)`，列为小游戏全局函数；页面另标注「微信 鸿蒙 OS 版：支持」；**未给最低基础库版本** |
| 实测 | 工具 lib **3.17.4** 下取不到该全局，`$a.start` 处直接抛错 → 游戏起不来（真机侧表现即「一直卡在加载界面」） |

## 关键时间线证据：这是环境变化，不是代码根本不可跑

| 时刻 | 环境 | 结果 |
|---|---|---|
| 先前 | 工具模拟器（当时能跑） | **画面正常**（Lv 6、每分钟 +20.0、已保存），见 `2026-10-13-simulator-01-first-run.png` |
| 手机首次 | **干净的包 A（无任何热修）** | **卡在加载界面** ⇒ 手机侧失败**与 Lead 的 shim 无关** |
| 现在 | 工具模拟器，报错显示 `lib: 3.17.4` | `requestAnimationFrame is not a function` |

`project.config.json` 里写的是 `"libVersion": "3.0.0"`，**但工具实际在跑 3.17.4** ⇒ 工具未按 `libVersion` 走（疑似 `project.private.config.json` 或缓存中的「调试基础库」设置）。

## 结论与不确定性

1. **手机当时的失败原因仍未知** —— 可能同样是 rAF 缺失，也可能是 H2-01（`canvas.addEventListener`）。二者是**独立**的两个假设，需要用手机 vConsole 的原文分辨。
2. 工具侧确证：**`requestAnimationFrame` 在该环境取不到** ⇒ 无论真机如何，`main.ts:49` 的裸全局写法**缺少兜底**，这是真实缺陷。
3. 恢复路径优先级：①工具「详情 → 本地设置 → 调试基础库」手动切回 `3.0.0`（或换其它版本）；②用含 rAF 垫片的包 D。

## 这是 Lead 评审的两处失误（如实记录）

1. 报告 21 曾把 `src/wechat/main.ts:49` 明确标注为「✅ 正确」（依据仅有官方文档），**未做任何环境侧验证** ⇒ 漏掉一个启动级 P0。
2. 报告 21 把 `compileType`「与官方文档不符」升级为需要处理的事项，并在包 B 中直接改成 `minigame`；
   而包 A 用 `game` 实测可跑 ⇒ **该改动不必要且导致工具 appservice 崩溃**（`something wrong in electron appservice`）。
   已回退：`apply-shim.mjs` 现在默认**不再改** `compileType`。

## 新增包
`D-wyszz-wechat-shim-raf.zip`：包 C 结构 + rAF 垫片（`setTimeout(…,16)` 兜底、回调回传 `Date.now()`），
`compileType` 保持 `game`；已用官方替身验证 **37/37 全过**（含 W12c 无报错）。
