"usesCleartextTraffic" : false
z***@163.com
- 发布：2026-04-07 17:26
- 更新：2026-04-07 17:30
- 阅读：11
产品分类： uniapp/App
PC开发环境操作系统： Windows
PC开发环境操作系统版本号： win10
HBuilderX类型： 正式
HBuilderX版本号： 5.06
手机系统： Android
手机系统版本号： Android 13
手机厂商： TCL
手机机型： TCL10PRO
页面类型： vue
vue版本： vue2
打包方式： 云端
项目创建方式： HBuilderX
App下载地址或H5⽹址： https://app.liuyingyong.cn/build/download/884554d0-325f-11f1-b05b-8fd13b4880f4
示例代码：
操作步骤：
新建项目->打开配置源码视图->在"app-plus"-> "distribute"->"android"->配置 "usesCleartextTraffic" : false
新建项目->打开配置源码视图->在"app-plus"-> "distribute"->"android"->配置 "usesCleartextTraffic" : false
预期结果：
android:usesCleartextTraffic="false"
android:usesCleartextTraffic="false"
实际结果：
android:usesCleartextTraffic="true"
android:usesCleartextTraffic="true"
bug描述：
需要补充详细的报错信息。
感谢反馈，针对这个 usesCleartextTraffic 配置被覆盖的问题，我进行如下评审：
反馈内容完整性评估
已提供的信息：
- 基础环境信息完整（HBuilderX 5.06 正式版、Windows 10、Android 13、Vue2）
- 问题描述清晰：配置
false后打包结果为true - 复现步骤基本可行，通过源码视图配置
app-plus->distribute->android->usesCleartextTraffic
需要补充的关键信息：
-
完整的 manifest.json 配置片段：目前只提供了
"usesCleartextTraffic" : false这一行，需要提供包含app-plus->distribute->android节点的完整配置结构，以确认配置位置是否正确。 -
打包方式说明：未说明是云打包还是离线打包（Android Studio 打包），这两种方式的配置处理机制不同。
-
验证证据：建议提供打包后的
AndroidManifest.xml中关于android:usesCleartextTraffic的实际截图或内容，以证实确实被覆盖为true。 -
项目类型：是否使用了第三方原生插件或 UTS 插件？某些插件可能会在合并配置时覆盖该属性。
Bug 成立性分析
经检索知识库，暂未找到关于 usesCleartextTraffic 配置被强制覆盖为 true 的已知问题或文档说明。
根据 Android 平台打包机制，usesCleartextTraffic 的配置应当直接映射到 AndroidManifest.xml 的 application 节点。如果确实出现配置被覆盖的情况，可能原因包括：
- 配置路径错误（未放在正确的
distribute->android节点下） - 使用了特定模块或插件（如 X5 内核、特定广告 SDK 等）强制开启了明文流量
- 调试模式与发布模式的差异（某些调试功能可能自动开启明文传输）
建议补充的复现材料
为了准确定位问题，请补充以下信息：
-
manifest.json 的 app-plus 配置片段（脱敏后）：
{ "app-plus": { "distribute": { "android": { "usesCleartextTraffic": false, // ... 其他配置 } } } }本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent
-
打包方式：云打包还是离线 SDK 打包？
-
插件使用情况：是否集成了腾讯 X5 内核、uni-ad 广告、或其他需要明文传输的第三方 SDK？
-
验证方式：通过什么方式查看的最终
AndroidManifest.xml？（建议解压 APK 后查看AndroidManifest.xml确认）
如果在补充信息后确认是框架层问题，我们将录入 issue 系统跟进。目前建议先检查是否有其他配置项或插件依赖导致了该属性被强制设置为 true。
内容为 AI 生成，仅供参考
