通过小程序分享卡片无法打开小程序,小程序加载失败(10003026)
133 浏览2026年05月27日作者:fluffyox

现象

把分享卡片发到抖音聊天 / 转发到群里之后,对方点击卡片进入小程序时直接白屏,提示:

备注:正常可以打开,唯独通过分享测试无法打开,且在抖音后台配置了分享模板

▎ 小程序加载失败 (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. 有没有踩过同样的坑然后解决了的同学,能讲下具体是改了哪里?

非常感谢任何线索 🙏

最后一次编辑于 2026 年 05 月 29 日
共 3 条评论

相关问答

专题推荐

热门文章

热门问答