现象
把分享卡片发到抖音聊天 / 转发到群里之后,对方点击卡片进入小程序时直接白屏,提示:
备注:正常可以打开,唯独通过分享测试无法打开,且在抖音后台配置了分享模板
▎ 小程序加载失败 (10003026)
发送方自己点回自己分享的卡片也是同样的报错。同一个小程序在「发现 -
小程序」入口直接打开是正常的,所以基础包应该没问题。
环境
- uni-app + Vue 3 + TypeScript
- 编译目标:MP-TOUTIAO
- 小程序版本:开发版 / 体验版(线上版同样没过审,所以暂时只能在体验版上测)
- 抖音开发者工具版本:最新稳定版
- 分享类型:onShareAppMessage(右上角"更多" → 分享 / <button open-type="share">)
当前分享配置
我用一个统一的 composable 配置所有页面的分享,关键代码:
// src/composables/useShare.ts
import { onShareAppMessage } from '@dcloudio/uni-app';
const TEMPLATE_ID = 'a54ci391fc3eqm283b';
export function useShare(options: ShareOptions | (() => ShareOptions)) {
onShareAppMessage((res) => {
const opts = typeof options === 'function' ? options() : options;
const params: Record<string, string> = {
from: res.from ?? '',
page: opts.pagePath ?? '',
...opts.extraQuery,
};
const qs = Object.entries(params)
.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
.join('&');
const sharePath = `/pages/share-landing/index?${qs}`;
return {
title: opts.title,
path: sharePath,
templateId: TEMPLATE_ID,
success() { console.log('[Share] panel opened'); },
fail() { console.warn('[Share] panel failed'); },
};
});
}页面调用:
useShare({ title: '薪途数据' });
分享落地页是一个中转页 pages/share-landing/index,它会读取 query、写入 store,然后 uni.switchTab 跳回首页 tab:
// src/pages/share-landing/index.vue
onLoad((options?: Record<string, string>) => {
// #ifdef MP-TOUTIAO
tt.hideShareMenu();
// #endif
if (options?.shareFrom) {
appStore.pendingShareParams = { ...options };
}
uni.switchTab({ url: '/pages/home/index' });
});
pages.json 里 share-landing 已注册:
{
"path": "pages/share-landing/index",
"style": {
"navigationBarTitleText": ""
}
}
实际发出的分享路径
控制台里能看到面板拉起成功([Share] panel opened),返回给抖音的 path 形如:
/pages/share-landing/index?from=menu&page=
templateId 是 'a54ci391fc3eqm283b',是在开放平台「分享模板」里配置好审核通过的那条。
已经排查过的点
- [x] path 以 / 开头,且与 pages.json 中注册的路径完全一致
- [x] 中转页 pages/share-landing/index 是主包页面,不在分包里
- [x] templateId 复制自开放平台后台,已审核通过
- [x] 移除 templateId 单独传 path + title,错误依旧
- [x] 把 path 直接改成 /pages/home/index(一个 tab 页),错误依旧
- [x] 体验版已经把测试账号都加进白名单
- [x] 开发者工具里"真机调试 - 分享"看不到额外错误信息
想请教的问题
1. 10003026 在抖音侧具体代表什么? 文档里这个错误码语焉不详,是 path 不合法 / templateId 不匹配 / 小程序状态 /
还是别的?
2. templateId 是否对 path 有强约束? 比如必须是模板审核时填的那个落地路径?我现在落地是 share-landing
中转页,模板里填的路径如果是 home 会不会冲突?
3. 未发布的体验版小程序,分享卡片能否被白名单外的人点击打开? 还是说必须等审核通过后才能验证完整分享链路?
4. 有没有踩过同样的坑然后解决了的同学,能讲下具体是改了哪里?
