公告 新用户注册即享 免费 SSL 证书 · 域名批量查询单次支持 40 个 · 香港与内地节点均可自助开通
解决方案 帮助中心 关于我们
代理合作 控制台 登录 免费注册

支付宝小程序链接生成与解析

按 alipays://platformapi/startapp 的约定组装两种链接:固定 appId=20000067 在支付宝内置浏览器里打开一个网页,或用 appId、page 与双层编码的 query 打开小程序页面;也可以把一条已有链接拆回各字段。

先看四条限制

  1. 页面路径必须是小程序里真实存在的页面,否则打不开。page 由小程序开发者预先定义,本工具只按规则拼串,不校验有效性,也不保证一定能唤起。
  2. 光传参数不会自动生效。链接只负责把 query 带过去,小程序代码要自己读取这些参数再决定跳转或展示;页面没写读取逻辑,参数就等于没传。
  3. 手拼 scheme 只适合自测。正式对外投放应走服务端接口 alipay.open.mini.scheme.create 生成,可设置有效期,也更稳定。
  4. 微信内置浏览器通常无法唤起 alipays://。PC 端能否打开取决于是否安装了支付宝客户端,移动端也需要已安装支付宝。

链接工具

组装 · startapp

当前方向:组装。填写 appId 与页面路径,再按需添加 query 参数,点「生成链接」得到完整的 alipays:// 链接。

当前模式:打开网页。appId 固定为 20000067,网址整体做一次 encodeURIComponent 后放进 url。

固定参数 appId=20000067 由支付宝内置浏览器打开该网址,appId 不需要也不能改。
必须以 http:// 或 https:// 开头。粘贴内容首尾的空格、反引号、尖括号、Markdown 链接壳会自动去掉。
alipays://platformapi/startapp?appId=20000067&url=<网址整体编码后的结果>
填写要打开的网址,点「生成链接」。网址必须以 http:// 或 https:// 开头。
结果仅供复制,页面不会把它做成可点击链接,避免直接唤起客户端。

这个工具做什么

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 字符。

提醒:复制链接后请自行确认 appId、page 与参数顺序。本工具不发起网络请求,不会唤起支付宝,也不判断链接是否有效。

下一步:把结果放到线上环境

支付宝小程序链接生成与解析的结果要落地,还需要一台可用的服务器与运行环境,先确认 CPU、内存与带宽。

推荐产品 云服务器 小程序需要自建后端或素材存储时,云服务器比虚拟主机更灵活。 查看配置与价格
需要协助 提交工单 部署或联调卡住时,把报错与配置贴进工单,7×24 小时有人跟进。 提交工单