scene必须是URL-safe的32字节内纯字符串，禁用?&=等符号，推荐下划线/斜杠分隔；ThinkPHP需json_encode传参并设Content-Type；小程序端须decodeURIComponent后再按约定拆解。
ThinkPHP 后端调用 wxacode.getUnlimited（即接口B）生成小程序码时，scene 不是随便拼字符串的事——它既要能被微信服务端接受，又得让前端小程序可靠还原出原始参数，稍不注意就会出现 options.scene 拿不到、解码失败、或只取到一半值的情况。
scene 字符串必须 URL-safe，且不能含 ? & = 等 query 分隔符
接口B 的 scene 是直接嵌入二维码 payload 的纯字符串字段，微信服务器不会把它当 URL query 解析。但很多开发者习惯传 "id=123&source=share"，结果前端拿到的是 "id=123%26source=share"，再用 decodeURIComponent 解出来仍是乱序或截断的。
- 错误写法：
scene: "user_id=1001&channel=wechat"→ 前端options.scene可能只收到"user_id=1001"，后面被丢弃 - 正确思路：把多个参数扁平化为单个 URL-safe 字符串，比如用下划线、斜杠、冒号分隔
- 推荐格式：
"u_1001_c_wechat"或"user/1001/channel/wechat"或"1001:wechat" - 避免使用空格、中文、
%、#、{}等未编码就非法的字符；即使编码了，也增加前端解析负担和出错概率
ThinkPHP 中构造 scene 并传给微信 API 的实操要点
在 ThinkPHP 控制器里调用接口B时，scene 要作为 JSON 字段的一部分 POST 出去，不是拼在 URL 上。别漏掉 json_encode 和 header 设置。
- 确保 POST 请求头包含
Content-Type: application/json，否则微信返回{"errcode":41009,"errmsg":"invalid post data"} - 不要用
http_build_query，必须用json_encode包裹整个参数数组 - 示例代码片段（TP6）：
$data = [
'page' => 'pages/detail/detail',
'scene' => 'u_' . $userId . '_c_' . urlencode($channel),
'width' => 430,
'auto_color' => false,
'line_color' => ['r' => 0, 'g' => 0, 'b' => 0]
];
$result = Http::post('https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=' . $accessToken, json_encode($data), [
'headers' => ['Content-Type' => 'application/json']
]);
-
urlencode($channel)仅用于防止单个字段含特殊字符（如channel="app-share"），不是给整个scene做 encode —— 那会多套一层，前端解一次根本拿不到原值
小程序端获取并解析 scene 的标准流程
前端不能直接信任 options.scene 的原始值，必须走固定两步：先判断是否存在，再 decodeURIComponent，最后按约定格式拆解。
name wechat-article-writer-pro description 微信公众号文章完整生成技能（专业版）。输入主题即自动完成：信息调研、文章撰写（含章节配图）、5个备选爆款标题、封面图生成、带格式排版的DOCX文档输出。触发词：写公众号文章、生成公众号内容、做微信推文、公众号文章完整版。 agent_created true 微信公众号文章完整生成技能（专业版） 概述 本技能提供微信公众号文章从主题到成品的完整生成流程，在基础版之上增加：章节配图、DOCX 格式输出（含彩色重点文字和表格
立即学习“PHP免费学习笔记（深入）”；
- 必须在
onLoad或onShow中处理，onLaunch拿不到scene（除非冷启动扫码进入） - 错误写法：
const s = options.scene.split('&')→ 完全不可靠，因为&本身可能就是业务数据 - 正确写法（以
"u_1001_c_wechat"为例）：
onLoad(options) {
if (options.scene) {
const scene = decodeURIComponent(options.scene);
const parts = scene.split('_');
const userId = parts[1];
const channel = parts[3];
// 后续业务逻辑
}
}
- 如果业务参数变多，建议改用
JSON.stringify+encodeURIComponent双重封装（但要控制总长 ≤ 32 字节），例如：encodeURIComponent(JSON.stringify({uid:1001, ch:'wechat', ts:Date.now()}))
容易被忽略的兼容性与长度限制
scene 看似自由，其实有硬性约束：微信文档明确要求最大 32 字节（不是字符数），且基础库 1.1.0+ 才支持该字段。低版本用户扫码后 options.scene 为空。
- PHP 中用
strlen()判断字节长度，不是mb_strlen()；中文字符一个占 3 字节，很容易超 - 测试时务必用真机扫码，开发工具模拟的
scene参数是明文传入的，不经过 URL 编码/解码链路，会掩盖问题 - 如果需要携带长文本（如邀请码、加密 token），应改用短 ID 映射表：后端生成 8 位随机码存 DB，
scene只传这个短码，小程序进来的再查表还原
真正卡住人的从来不是「怎么调通接口」，而是 scene 在传输链路中被悄悄编码、截断、或误解析——盯住字节长度、避开 query 符号、前后端约定好解析逻辑，比堆功能重要得多。
