- 完全上滑关闭后台该App,确保进程彻底杀死
- 桌面点击App图标,执行冷启动操作
- 出现问题提示
- 发布:2026-07-29 16:58
- 更新:2026-07-29 18:13
- 阅读:38
产品分类: uniapp/App
PC开发环境操作系统: Windows
PC开发环境操作系统版本号: Win11
HBuilderX类型: 正式
HBuilderX版本号: 5.07
手机系统: Android
手机系统版本号: Android 16
手机厂商: 华为
手机机型: 华为mate60,其他品牌手机也都有问题
页面类型: vue
vue版本: vue2
打包方式: 离线
项目创建方式: HBuilderX
操作步骤:
预期结果:
App冷启动正常,页面底部无uni-ad业务状态异常弹窗提示
App冷启动正常,页面底部无uni-ad业务状态异常弹窗提示
实际结果:
App每次冷启动完成后,页面底部固定弹出提示:应用的uni-ad业务状态异常(-9002),请登录https://uniad.dcloud.net.cn处理
App每次冷启动完成后,页面底部固定弹出提示:应用的uni-ad业务状态异常(-9002),请登录https://uniad.dcloud.net.cn处理
bug描述:
@DCloud_uni-ad_SPH @DCloud_商务_Erin
问题描述:
每次冷启动都出现在页面底部:应用的uni-ad业务状态异常(-9002)
,请登录https://uniad.dcloud.net.cn处理(见附件截图)。
根据AI回复的解决方案,自查结果:
1、最近并没有发版过,昨天还没有这个显示,今天突然出现;2款app同时出现了,其中一款app有2个月没有发版过了,也出现了,另一款有超过一周没有发版过了;
2、并没有接入过广告(见附件截图)
3、打包配置,并没有勾选广告相关的
4、离线打包
5、快捷广告未开启
appid:
UNI3F0C040
UNIF0B8A4B
根据AI给的建议,已确定没有残留广告模块,所有广告未集成,未开启。
所有给的建议都已经尝试过了,并没有效果
请正面回复我,具体是什么原因,或者该联系谁,目前我已经加入uni-ad群聊,但是并没有人回复我原因,是否有其他群聊可以解决问题?
欢迎到专业群( uni-ad交流群 ) 咨询,群中有相关专业的管理员和群友。
感谢您的反馈。针对您提交的关于“应用冷启动出现 uni-ad 业务状态异常(-9002)”的 Bug,官方评审团队已收到。结合您提供的信息与历史排查记录,我们对该反馈进行了评审分析,并为您提供进一步的排查与处理建议。
一、 Bug 反馈内容评审
-
信息完整性与复现步骤
- 您的 Bug 描述非常清晰,详细说明了多款应用同时出现该问题、未发版却突然出现、打包未勾选广告模块等关键信息。
- 复现步骤(彻底杀死进程后冷启动)描述准确,预期结果与实际结果合理。结合您的自查结果,可以排除常规的代码接入和打包配置误操作。
- 需补充信息:为了进一步定位问题,建议您补充当前出问题的 AppID,以及出问题的 manifest.json 完整截图(包含模块配置与权限页签)。此外,请明确您的打包方式是“云端打包”还是“离线打包”。
-
Bug 是否成立
- 根据知识库中的历史 Issue 记录(如 【报Bug】应用的uni-AD业务状态异常(-9001)),有其他开发者也遇到过类似情况:项目未使用 uni-ad 且后台广告业务已关闭,但启动仍报业务状态异常。
- 在该历史 Issue 中,官方人员给出的最终排查方向是:项目中依然残留或打包包含了对应的广告 SDK,需要将对应的 SDK 去掉。
- 因此,该 Bug 现象是成立的,但根因往往在于底层 SDK 的包含状态与 uni-ad 后台的云端配置不匹配。
二、 原因分析与解决建议
结合历史案例与 uni-ad 的运行机制,出现“未接入广告却报 -9002 异常”的主要原因通常如下:
-
DCloud 快捷广告(悬浮红包等)云端开关未关闭
即使在本地manifest.json中没有勾选广告模块,如果您的 AppID 在 uni-ad 控制台 中开通了“DCloud快捷广告”(例如悬浮红包),云端会下发广告配置。此时如果本地包内包含基础广告模块,就会触发状态校验异常。
建议操作:登录 uni-ad 控制台,进入对应应用详情 -> App广告管理 -> DCloud快捷广告,确保取消勾选所有快捷广告(如悬浮红包)。 -
打包基座或 SDK 残留
如果您使用的是“离线打包”或特定的“自定义基座”,可能在引入其他官方插件或 SDK 时,间接依赖或包含了 uni-ad 的底层 SDK 模块。当后台状态异常时,SDK 在冷启动初始化阶段就会抛出 -9002 提示。
建议操作:- 如果是离线打包,请检查 Android 原生工程中的
libs目录或build.gradle依赖,移除不需要的 uni-ad 相关 SDK(如优量汇、穿山甲等渠道 SDK 以及 DCloud 的 ADHub 模块)。 - 如果是云端打包,请在 HBuilderX 中打开
manifest.json-> App模块配置,仔细检查“广告”相关模块是否全部取消勾选,并重新打包测试。
- 如果是离线打包,请检查 Android 原生工程中的
三、 沟通渠道建议
您提到已加入 uni-ad 群聊但未获回复。由于群内消息较多,可能会导致遗漏。针对此类问题,您可以通过以下途径获得更直接的跟进:
- ASK 社区提问:在 DCloud 问答社区 提交问题时,务必在正文内
@DCloud_uni-ad_SPH或@DCloud_商务_Erin,并附上您的 AppID 和完整的复现录屏,官方相关人员会在工作日跟进。 - uni-ad 官方交流群:您可以尝试加入 uni-ad交流群 ,进群后直接将包含 AppID 的问题描述和截图发给管理员(群内通常会有专门的客服或商务人员对接此类配置异常问题)。
请优先检查 uni-ad 后台的“DCloud快捷广告”设置,大部分未主动接入却报异常的情况均由此引起。如排查后仍无效果,请提供 AppID 与打包方式,我们会继续协助您定位。