ThinkPHP调用微信getWXACodeUnlimit接口需严格处理参数签名、JSON格式POST请求及access_token缓存刷新;scene须为URL编码字符串,响应为二进制PNG流,需校验后保存至public/static/qrcode/并确保路径可访问。

ThinkPHP 调用微信 getWXACodeUnlimit 接口生成带参小程序码
直接调用微信 API 生成带参小程序码,关键不是“能不能”,而是参数签名、POST 体格式、access_token 刷新这三处必须严丝合缝。ThinkPHP 自身不封装该接口,得自己拼 URL、构造 JSON Body、处理 token 过期。
-
scene参数必须是字符串(如"user_id=123&source=share"),不能传数组,微信后端只认 URL 编码后的字符串值 - 必须用
POST请求,Content-Type: application/json,Body 是纯 JSON —— ThinkPHP 的Http::post()或原生cURL都行,但别用input()模拟 POST 表单 -
access_token有效期 2 小时,建议存到缓存(如cache('wx_access_token')),每次请求前先查缓存,过期再调https://api.weixin.qq.com/cgi-bin/token刷新 - 返回是二进制图片流,不是 JSON。别用
json_decode()解析响应体,直接写入文件或输出:file_put_contents($path, $response)
生成后的小程序码图片在 ThinkPHP 中保存为本地文件
微信返回的是 raw image data(image/png),ThinkPHP 不会自动识别类型或补扩展名,保存时得自己定路径、判目录、写权限。
- 保存路径建议用
public/static/qrcode/,确保 Web 可直接访问,避免放在runtime/等非公开目录 - 文件名不要硬编码,推荐用
md5($scene . $page . time()) . '.png',避免中文或特殊字符导致写入失败 - 务必提前创建目录并检查写权限:
if (!is_dir($dir)) mkdir($dir, 0755, true),否则file_put_contents静默失败 - 保存前建议加一层校验:响应头含
Content-Type: image/且内容长度 > 1000 字节,再写盘,防止 token 错误返回 HTML 错误页被当图存下来
为什么 getWXACodeUnlimit 返回 41001(access_token 缺失)?
这不是 ThinkPHP 的锅,是微信鉴权链路断在了某一处。90% 的情况是 token 拿到了但没传对,或者传了却因格式问题被忽略。
- 检查 URL 是否拼成了
https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=xxx—— 错!access_token必须放 HTTP Header:Authorization: Bearer xxx或更常见的是access_token放 query,但 body 里不能再重复传 - 确认 token 字符串里没有空格、换行、引号 —— 从缓存读出来后用
trim()清一下最稳妥 - 如果用了代理或 CDN,确认没把
Authorization头过滤掉;某些 Nginx 配置默认屏蔽带下划线的 header - 错误响应体如果是
{"errcode":41001,"errmsg":"access_token missing"},说明微信根本没收到 token,优先查请求发出前的变量 dump,而不是查 token 生成逻辑
小程序码图片转存后无法在前端显示(404 或损坏)
常见于路径拼错、Web 根目录理解偏差、或图片内容实际是错误 HTML。
立即学习“PHP免费学习笔记(深入)”;
- 前端访问地址必须是完整 URL,比如
https://yoursite.com/static/qrcode/abc.png,不是/static/qrcode/abc.png(相对路径易受路由影响) - 用浏览器直接打开该 URL,看是否返回 PNG 内容;如果返回 “No input file specified” 或微信错误页,说明保存时写进了错误响应
- 用
file_get_contents()读刚保存的文件,bin2hex(substr($data, 0, 4)) === '89504e47'可快速判断是不是真 PNG(PNG 文件头是\x89PNG) - ThinkPHP 开启调试模式时,
var_dump响应体容易截断二进制,改用file_put_contents('debug.bin', $response)抓原始流再分析


















