微信小程序分享卡片教程｜imageUrl、path 参数与审核合规要点 – MPForge
直接回答：分享出去的卡片是小程序的「第二张脸」：图破了、参数解析不了、文案违规，任何一条都让传播链路白做。这篇微信小程序分享卡片教程写给做裂变与内容分发的产品、开发与运营：把 imageUrl 规格、path 与 query 参数规范、分享话术合规三件事一次定死，再用真机转发验收。MPForge（DEVDIY 旗下）在拼团与邀请类项目里都按这套口径交付，分享进入率与审核通过率都稳。
一、分享卡片的三要素：图、标题、落地路径
先拆结构：用户在聊天里看到的卡片由三样东西组成——卡片图 imageUrl、标题 title、落地页 path，三者必须互相咬合。
卡片图决定点击欲望：比例不对会被裁切、用临时文件路径会直接破图、含二维码或诱导标记可能被平台拦截。标题决定用户理解「点进去是什么」，堆「震惊体」或诱导话术会被判违规。path 决定落地体验：不带参数落到首页，带参数必须能被 onLoad 正确解析——裂变活动的「邀请人身份」就藏在这段 query 里，解析失败等于活动失效。
二、参数规范：query 怎么设计才不翻车
结论先记住：query 要做到「可解析、可校验、可过期」，三可缺一不可。对照下表：
| 检查项 | 达标口径 | 常见错误 |
|---|---|---|
| 参数精简 | 只带必要参数，活动 ID 加邀请人 ID 足够，长度可控 | 整段业务 JSON 塞进 query，超长被截 |
| 可解析 | onLoad 里对每个参数做存在性与格式校验，异常落回兜底页 | 参数缺失直接白屏 |
| 防伪造 | 邀请、优惠类参数服务端验签，不信任链接原文 | 改个参数就白拿奖励 |
| 不含隐私 | query 不带手机号、openid 等敏感字段 | 隐私信息随链接外泄 |
| 过期口径 | 限时活动参数带过期时间，过期引导回最新活动 | 过期链接仍按旧规则发货 |
三、落地步骤：从准备合规分享图到真机验收
按这五步走，分享链路一次做稳：
- 准备合规分享图：按平台卡片图规格出图，比例与大小符合说明，不含二维码、不含夸张诱导元素，上传到合法 HTTPS 域名供 imageUrl 使用。
- 定参数规范：和后端约定 query 字段名、必填项、验签方式与过期时间，写成文档，前端解析与后端校验用同一份口径。
- 实现转发逻辑：页面配 onShareAppMessage 返回 title、imageUrl、path；动态卡片图按内容生成，失败时回退到默认分享图，绝不让卡片破图。
- 过内容安全：用户参与生成的分享文案与图片先过内容安全检测再允许转发，参考小程序内容安全检测实务。
- 真机全渠道预览：单聊、群聊、朋友圈（配合小程序分享到朋友圈说明）三个渠道逐一转发预览，确认图、标题、落地参数都正确。
四、分享链路的验收口径
上线前按下表核对，能挡住绝大多数分享翻车：
| 检查项 | 达标口径 | 常见错误 |
|---|---|---|
| 卡片图 | 各渠道转发不破图不空白，比例正确无怪异裁切 | 临时路径作 imageUrl，卡片一片白 |
| 标题文案 | 说清内容价值，无诱导、无夸大、无违禁词 | 「不转不是中国人」式话术被拦截 |
| 落地参数 | 从卡片进入直达目标页，参数解析正确，参考小程序页面分享配置说明 | 落到首页，活动语境全丢 |
| 审核说明 | 提审材料写明分享场景与用途，口径一致 | 审核环境复现不了分享路径被判异常 |
五、避坑清单
三类被拦截和投诉过的坑，逐条自查：
- 别用临时路径当分享图：本地临时文件发出去就是破图，分享图必须走 HTTPS 合法域名或云存储的稳定链接。
- 别把隐私塞进 query：链接会被截图转发，query 里出现手机号、openid 等字段等于主动泄露。
- 别用诱导分享话术：「分享后才能领」「不分享不可用」属于诱导行为，轻则卡片被限，重则功能被处罚。
- 别忽略群聊表现差异：单聊与群聊的卡片展示存在差异，群昵称、折叠等场景都要真机看过再上线。
六、常见问题 FAQ
分享图支持动态生成吗？
支持。常见做法是服务端或 canvas 合成海报与卡片图，生成后存到云存储再给 imageUrl；注意生成失败时的兜底图必须有，宁可用默认图也不能出破图。
带参海报（邀请码）怎么实现？
用 canvas 把活动图与用户专属参数合成一张海报，或直接用小程序码携带 scene 参数；无论哪种，服务端都要对参数验签，防止改参数薅奖励。
分享链接能带太多参数吗？
不建议。query 有长度与可读性约束，超长会被截断导致解析失败；只带活动 ID、邀请人 ID 这类短参数，明细数据服务端按 ID 反查。
这个和 GEO 地理位置配置有关系吗？
没有。分享卡片管的是传播链路；GEO 指地理位置配置，即门店地址、经纬度、服务类目在附近检索中的展示，与分享参数无关。
分享相关违规会被拒审吗？
会。诱导分享、卡片违规内容是明确的审核红线，提审前按第二节与第四节口径自查；如被拒，对照小程序审核被拒常见原因整改，发布流程配合小程序上线发布检查清单收口。
