这个工具做什么
alipays://platformapi/startapp 是支付宝客户端的自定义协议链接,最常见两种用法。打开网页:appId 固定写 20000067,把完整网址整体编码一次后放进 url,由支付宝内置浏览器加载。打开小程序页面:appId 指明哪个小程序,page 指明哪个页面,query 把页面需要的参数打包成一个字符串。它看起来像网址,实际由操作系统交给支付宝客户端处理,浏览器不会去访问服务器。
两种模式的编码层次不同。打开网页只需要一层:url 的值就是 encodeURIComponent(完整网址)。打开小程序页面需要两层:每个键和值先各自编码,用 & 拼成内层查询串,再把整个内层串编码一次后作为 query 的值。少一层,内层的 & 就会被外层当成参数分隔符,参数直接被拆散。
本工具提供组装与解析两个方向,组装下再分这两种模式。所有计算都在浏览器本地完成,不发送任何请求。
怎么用
先用方向按钮选择「组装」或「解析」。组装方向下再选择「打开网页」或「打开小程序页面」,切换模式时输入区会跟着换,生成结果会清空。
打开网页。只填一个网址,必须以 http:// 或 https:// 开头。从文档复制时常见的首尾空格、反引号、尖括号、Markdown 链接壳([文字](网址))会在生成前自动去掉,不需要手工清理。appId 固定为 20000067,不提供输入框。填好后点「生成链接」,结果出现在只读文本框里。
打开小程序页面。填写 appId 和 page。appId 必须是纯数字,带空格或字母会直接报错,不会生成坏链接;page 不能为空且不能以斜杠开头,例如 pages/index/index。需要传参时点「添加参数」,逐行填 key 与 value。key 为空的行会被跳过,重复 key 不去重。没有参数时链接自动省略 query=。「载入示例」会按当前模式填入一组示例。
解析方向。粘贴一条以 alipays:// 开头的链接后点「解析」。appId 为 20000067 且带 url 时按「打开网页」模式展示解码后的网址;其余情况按小程序页面展示 appId、page 和解码一次后的 query 原文,下方再把 query 拆成键值表。解析结果只读。
结果怎么解读
打开网页:只有一层编码
生成结果形如 alipays://platformapi/startapp?appId=20000067&url=https%3A%2F%2Fxinyiidc.com%2Fpage%3Fa%3D1。%3A 是冒号、%2F 是斜杠、%3F 是问号、%3D 是等号,都来自对整条网址做的那一次编码。解析时 URLSearchParams 解码一次即可还原成可读网址。
打开小程序页面:为什么 query 看起来编码了两次
因为页面参数本身是一个查询串,而它又要作为一个参数值放进外层查询串。例如页面需要 target=https://xinyiidc.com/page:第一步分别编码键和值,得到 target%3Dhttps%3A%2F%2Fxinyiidc.com%2Fpage;第二步把这整串再编码一次,变成 target%253Dhttps%253A%252F%252Fxinyiidc.com%252Fpage,最终外层看到 query=target%253Dhttps%253A%252F%252F...。第二层里的 %25 是百分号本身被编码的结果,不是错误。
如果只编码一层,内层的 & 在外层解码后会变成普通分隔符。原本属于网址的 &b=1 会变成另一个独立的 query 参数,这就是「参数被拆」的典型现象。
page 的百分号编码
链接里的 page 可能写成 pages%2Findex%2Findex,其中 %2F 代表斜杠。解析时 URLSearchParams 会自动解码一次,页面路径便还原成 pages/index/index 展示。
打开网页模式的识别
解析时会检查 appId 是否为 20000067。是则视为打开网页,只展示解码后的 url,不再显示 page 与 query 表。若 appId 是 20000067 却没有 url,会按小程序页面解析,并提醒这条链接缺少 url,通常无法打开网页。
常见的几种情况
参数被拆、只传过去一半
绝大多数是 query 少编了一层,或网址值只编码一次就拼进 query。检查方法:解析结果里如果出现本不属于页面的参数名(例如网址里的 b),就说明内层没有整体编码。回到组装区用双层编码重新生成即可。
粘贴的网址带反引号或 Markdown 壳
文档里复制的链接常写成 `https://...`、<https://...> 或 [标题](https://...)。这些符号会被原样编码进 url,支付宝当然打不开。工具在生成前会自动剥掉首尾空格、反引号、尖括号,并取出 Markdown 括号里的网址,同时在状态栏说明做了清理。
appId 带了空格或字母
生成前会做纯数字校验。appId 里只要出现空格、换行、字母或全角字符就报错并停止生成,不会输出一条看似完整但实际唤不起来的链接。20000067 与 2021 开头的小程序 appId 都符合这条规则。
page 以斜杠开头
写成 /pages/index/index 会被拒绝,正确写法是 pages/index/index。前导斜杠会让客户端按绝对路径处理,常导致页面找不到。
生成链接后无法唤起
先确认 appId 与 page 是否属于同一个真实存在、已经发布的小程序或页面,再确认当前环境。微信内置浏览器出于策略限制通常无法唤起 alipays://;电脑上需要安装支付宝客户端并允许协议处理;手机上也需要安装支付宝。工具只负责拼串,无法验证这些外部条件。
使用限制与提醒
页面路径必须真实存在。工具不会向支付宝查询 appId 是否存在,也不会检查 page 是否注册过,更不会验证 query 是否被页面接受。能不能打开、打开后显示什么,取决于小程序实现与运行环境。
光传参数不会自动生效。链接只负责把 query 带到页面,小程序代码要自己读取参数再决定跳转或渲染。页面没写读取逻辑,参数就等于没传。
手拼 scheme 只适合自测。正式对外投放应改用服务端接口 alipay.open.mini.scheme.create 生成,可设置有效期,也更稳定。
微信内置浏览器通常无法唤起。需要覆盖微信场景时,应改用对应平台的落地方式,而不是指望 alipays:// 在微信里直接生效。
链接中的参数会以明文形式出现在地址里,任何拿到链接的人都能看到。不要把手机号、身份证号、访问令牌或签名密钥直接放进 query。页面不联网、不保存输入历史;解析长度上限 4,000 字符。