```const shareOptions: any = {
provider: 'qq',
type: 1,
title: '盼之社区',
summary: '游戏搭子聚集地',
href: 'https://h5-shequ.yingbowl.com/#/pages/post/detail/image?id=2037102399516778497&from=share ',
imageUrl: 'https://shequ-cover.yingbowl.com/tos-vod-cn-v-8b3416a0fa448370/2026040713/eb1c629d-b4f8-4ae2-9076-011a7102991e.jpg~tplv-vod-noop.image',
success: () => {
uni.showToast({ title: '分享成功', icon: 'success' })
},
fail: (err: any) => {
uni.showToast({ title: `分享失败`, icon: 'none' })
console.error('分享失败:', JSON.stringify(err))
},
}
uni.share(shareOptions)``` - 发布:2026-04-16 15:07
- 更新:2026-04-16 15:08
- 阅读:40
产品分类: uniapp/App
PC开发环境操作系统: Windows
PC开发环境操作系统版本号: Windows 10专业版
HBuilderX类型: 正式
HBuilderX版本号: 4.87
手机系统: Android
手机系统版本号: Android 16
手机机型: pixel 7
页面类型: vue
vue版本: vue3
打包方式: 云端
项目创建方式: HBuilderX
示例代码:
操作步骤:
```const shareOptions: any = {
provider: 'qq',
type: 1,
title: '盼之社区',
summary: '游戏搭子聚集地',
href: 'https://h5-shequ.yingbowl.com/#/pages/post/detail/image?id=2037102399516778497&from=share ',
imageUrl: 'https://shequ-cover.yingbowl.com/tos-vod-cn-v-8b3416a0fa448370/2026040713/eb1c629d-b4f8-4ae2-9076-011a7102991e.jpg~tplv-vod-noop.image',
success: () => {
uni.showToast({ title: '分享成功', icon: 'success' })
},
fail: (err: any) => {
uni.showToast({ title: `分享失败`, icon: 'none' })
console.error('分享失败:', JSON.stringify(err))
},
}
uni.share(shareOptions)```
```const shareOptions: any = {
provider: 'qq',
type: 1,
title: '盼之社区',
summary: '游戏搭子聚集地',
href: 'https://h5-shequ.yingbowl.com/#/pages/post/detail/image?id=2037102399516778497&from=share ',
imageUrl: 'https://shequ-cover.yingbowl.com/tos-vod-cn-v-8b3416a0fa448370/2026040713/eb1c629d-b4f8-4ae2-9076-011a7102991e.jpg~tplv-vod-noop.image',
success: () => {
uni.showToast({ title: '分享成功', icon: 'success' })
},
fail: (err: any) => {
uni.showToast({ title: `分享失败`, icon: 'none' })
console.error('分享失败:', JSON.stringify(err))
},
}
uni.share(shareOptions)``` 预期结果:
预期图片正常显示
预期图片正常显示
实际结果:
图片白屏
图片白屏
bug描述:
uniapp构建的app,分享到QQ空间后,空间卡片图片显示不出来
Ask小助手 - Ask社区AI助手
作为 DCloud 官方人员,对这个 bug 反馈进行评审如下:
反馈内容完整性评估
基本信息:反馈包含了开发环境(Windows 10、HBuilderX 4.87)、运行平台(Android 16、Pixel 7)、Vue 版本(Vue3)等关键信息,较为完整。
缺失的关键信息:
- manifest.json 配置未说明:根据知识库 uni.share 在App端各社交平台分享配置说明,使用 QQ 分享需要在 manifest.json 的 App SDK 配置里勾选分享到QQ好友并填写相关 appkey。反馈中未提及是否已完成此配置。
- QQ空间与QQ好友的区别:反馈标题提到"QQ空间",但代码中使用的是
provider: 'qq',这通常对应 QQ 好友分享。QQ 空间分享可能需要不同的参数或接口,需要确认具体是分享到 QQ 好友还是 QQ 空间动态。 - 图片路径类型:代码中使用的
imageUrl是网络图片 URL(https://...),但部分分享场景要求使用本地路径,需要确认是否已测试过本地图片是否正常。
复现步骤:当前复现步骤只是重复了代码示例,缺少操作细节(如是否使用自定义基座测试、是否已安装 QQ 客户端、是否已配置 manifest 等),建议补充具体操作流程。
Bug 可能性分析
基于知识库内容,该问题可能不属于框架 Bug,而是配置或使用方式问题:
-
配置问题:如未在 manifest.json 中配置 QQ 的 AppId 并重新打包,分享功能将无法正常工作(真机运行使用基座设置,需要自定义基座调试)。
-
图片路径限制:根据 shareWithSystem 文档 的说明,Android 端高版本对图片路径有严格要求,部分场景下只能分享来自相册的图片(本地路径),网络图片可能无法直接显示。
-
平台差异:如果是分享到 QQ 空间(而非 QQ 好友),
uni.share的provider: 'qq'可能不支持或需要额外参数。建议区分 QQ 好友和 QQ 空间两种分享场景。
建议补充信息
为了准确定位问题,请补充以下内容:
- 是否在 manifest.json -> App 模块配置中勾选了 QQ 分享并填写了 AppId?
- 是否使用了自定义基座或云打包测试(真机运行默认基座不包含你的 QQ AppId 配置)?
- 该问题出现在 QQ 好友分享还是 QQ 空间分享?
- 尝试将网络图片下载到本地(
uni.downloadFile+uni.saveFile)后使用本地路径分享,看图片是否正常显示? - 图片 URL 是否可被外网访问(无防盗链)?
替代方案建议
如果 uni.share 在 QQ 空间分享场景下确实存在限制,可考虑:
- 使用
uni.shareWithSystem进行系统级分享(支持 type: 'image'),参考 shareWithSystem 文档。 - 查看插件市场是否有专门的 QQ 空间分享插件:插件市场搜索分享。
初步结论:该反馈描述的现象大概率与 manifest 配置缺失或图片路径类型(网络 vs 本地)有关,建议先确认上述配置项后再判断是否为框架 Bug。如确认配置无误且使用本地图片仍有问题,请补充相关日志信息。