Manifest merger failed 错误需运行 ./gradlew processDebugManifest --stacktrace 强制输出详细日志，重点查找“also present”“requires a placeholder substitution”等提示，定位冲突行号与属性名；tools:replace 必须在根节点声明命名空间、写在被冲突元素内、值用全限定名，占位符须在 build.gradle 中严格匹配 key 名补全定义。
Manifest merger failed 错误日志怎么快速定位
直接看终端输出的错误行号和属性名，别跳过 processDebugManifest 阶段的日志。Gradle 默认只报错不展开细节，必须加参数强制输出：
- 运行
./gradlew processDebugManifest --stacktrace或./gradlew processDebugManifest --info - 重点找类似
Attribute application@icon value=... is also present at [...]这类带“also present”的提示 - 如果提示
requires a placeholder substitution but no value for <XXX> is provided，说明${XXX}在build.gradle里没定义
很多开发者卡在第一步——没打开详细日志就盲目改 tools:replace，结果掩盖了真正的问题源。
tools:replace 不生效的三个常见原因
tools:replace 看似简单，但写错位置、漏命名空间、或覆盖范围不对都会让它失效：
- 必须在
<manifest>根节点声明命名空间：xmlns:tools="http://schemas.android.com/tools" -
tools:replace要写在被冲突的元素上，比如属性冲突发生在<application>，就得加在该标签内，而不是<manifest>或<activity> - 值必须写全限定名：
tools:replace="android:icon, android:theme"，不能简写成"icon, theme" - 如果冲突的是子节点（如重复的
<activity>），tools:replace无效，得用tools:node="replace"或tools:remove
权限和组件重复声明怎么处理
权限（<uses-permission>）默认是合并行为，但多个库声明同一权限不会报错；真正报错的是组件（<activity>、<service>）同名定义，或 <meta-data> 值冲突：
Android Remote Control
下载
远程控制 Android 设备，支持截图、自动化操作手机 App 等功能。本应用使用 uiautomator2 作为底层框架，通过 ADB 连接设备，用户无需 Root（1）查看手机屏幕；（2）自动化操作手机 App；（3）远程安装/卸载应用……
- 组件重复：错误提示含
duplicate declaration或name attribute is not unique，优先检查是否两个库都注册了同名ContentProvider或Activity - 解决方式不是硬加
tools:node="replace"，而是确认是否真需要保留——很多第三方 SDK 的ContentProvider是为跨进程服务设计的，删掉会导致功能异常 - 权限组合并出问题？极少发生，但如果某库用
tools:node="remove"删了你必需的权限，就得在主 Manifest 里显式重新声明
别迷信“删掉冲突项就完事”，先查文档确认那个组件/权限的实际用途。
占位符（manifestPlaceholders）报错时怎么修
像 android:value="${APP_ID}" 这种写法，一旦 build.gradle 没配 manifestPlaceholders，就会在 merge 阶段直接失败，错误信息明确指向缺失值：
- 在
defaultConfig或buildTypes/flavor里补全定义：manifestPlaceholders = [APP_ID: "com.example.app"] - 注意 key 名大小写必须完全一致，
${app_id}和app_id不匹配 - 如果 placeholder 出现在测试模块（
androidTest）的 Manifest 中，要配在androidTest对应的sourceSets或单独的testManifestPlaceholders（AGP 8.0+）
占位符是 Manifest 合并中最容易被忽略的隐性依赖点——它不报编译错误，但会在 merge 阶段静默失败，且错误位置常和实际声明位置隔得很远。
