调用美团AI发票识别API前必须确认三件事：一是申请专用app_id和app_secret并使用指定接口地址；二是按字典序拼接参数用HMAC-SHA256+Base64生成签名，timestamp须为秒级且动态；三是图片须为JPEG/PNG格式、Base64编码纯字符串、大小不超过2MB。
调用美团AI发票识别API前必须确认的三件事
美团AI发票识别不是本地函数，而是需要走 HTTP 请求的在线服务；没开通接口权限、没配好签名、没传对图片格式，401 或 400 错误会直接卡住，和 PHP 版本无关。
- 去
https://ai.meituan.com/申请「发票识别」能力，拿到app_id和app_secret（不是美团开放平台的通用密钥） - 接口地址是
https://ai.meituan.com/api/invoice/recognize，不是文档里其他路径，别套用 OCR 通用接口模板 - 图片必须 Base64 编码后作为
image字段 POST，不能传文件句柄、不能用cURLFile模拟表单上传
PHP 发送请求时最容易错的签名生成逻辑
美团要求的签名不是简单拼接，而是对参数做字典序排序 + HMAC-SHA256 + Base64，且 timestamp 必须是秒级 Unix 时间戳（不是毫秒），超时窗口默认 5 分钟。
-
timestamp和nonce必须随每次请求动态生成，硬编码会导致{"code":4001,"msg":"签名验证失败"} - 参与签名的字段只有：
app_id、timestamp、nonce、image（注意：image是 Base64 字符串本身，不是文件名） - 签名原文格式为：
app_id={}&nonce={}×tamp={}&image={}（按 key 字母序排列，无空格无换行） - 最终签名值要
base64_encode(hash_hmac('sha256', $sign_str, $app_secret, true))，漏掉true参数会导致结果不一致
Base64 图片处理的两个隐藏坑
直接用 file_get_contents 读图再 base64_encode 多数情况可行，但遇到 PNG 透明通道、WebP 格式或超大图时会触发美团服务端校验失败，返回 {"code":4002,"msg":"图片格式错误"}。
- 务必在编码前检查图片 MIME 类型：
exif_imagetype()或getimagesize()，只接受IMAGETYPE_JPEG、IMAGETYPE_PNG（WebP 不支持） - 超大图（如 >4MB）建议先用
imagejpeg()或imagepng()压缩到 2MB 内再编码，美团对原始尺寸无要求，但对 Base64 字符串长度有限制 - 不要手动拼
data:image/jpeg;base64,前缀——接口只要纯 Base64 字符串，加了前缀会解码失败
解析返回 JSON 时要注意字段稳定性
美团返回的 invoice_info 结构不是固定字段，不同发票类型（增值税专票/普票/卷票）返回的 key 差异很大，amount 可能叫 total_amount，invoice_code 在卷票里可能不存在。
立即学习“PHP免费学习笔记（深入）”；
- 别直接访问
$res->invoice_info->amount，先用isset()或??判断字段是否存在 - 关键字段优先级：优先取
invoice_code和invoice_number（发票代码+号码），再 fallback 到code和number（旧版字段） - 金额类字段统一转 float 后用
round($x, 2)格式化，避免科学计数法或精度丢失 - 如果
code是0但msg是空字符串，不代表成功——得看result里有没有invoice_info，有些识别失败也会返回code:0
真正麻烦的从来不是调通接口，而是发票图质量参差、字段命名不一致、还有那些没写在文档里的超时和重试策略。比如连续失败三次后，得换 nonce 再试，而不是死等。
