库引入场景下findFragmentById返回null问题排查

核心原因是宿主App资源覆盖了库模块的同名资源，和Navigation组件、FragmentManager逻辑无关。
Android构建流程的资源合并规则明确：宿主App的资源优先级高于所有依赖库的同名资源。你把模块作为库接入时，如果宿主工程里存在同名的activity_main.xml布局，setContentView(R.layout.activity_main)实际加载的是宿主里的布局文件，根本不是你库模块里写了FragmentContainerView的那份布局。宿主的布局里既没有id为wlimpl_main_activity_nav_fragment的NavHostFragment，也没有定义需要自动初始化的FragmentContainerView，自然会出现findFragmentById返回null、supportFragmentManager.fragments列表长度为0的现象。

在setContentView调用后加一行遍历当前view树的日志，打印所有子view的id，就能确认根本找不到你定义的NavHost对应的控件id。

• 彻底解决的方案：给库模块所有资源加上唯一的专属前缀，比如你的库模块标识是wlimpl，就把activity_main.xml改名为wlimpl_activity_main.xml，对应的布局id、颜色、导航图、字符串、图片资源全部统一加此前缀，从根源上避免和宿主资源重名被覆盖。
• 前置约束方案：在库模块的build.gradle中配置强制资源前缀规则，配置后Android Studio会自动校验所有资源名，漏加前缀时直接报错提醒，避免后续开发新增资源时重名：

android {
    resourcePrefix "wlimpl_"
    // 其余原有配置
}

不要尝试通过手动new NavHostFragment、事务提交的方式绕过问题，本质是布局加载错误，就算绕过这一步，后续库模块里的导航图、颜色、字符串等其他资源只要和宿主重名，依然会出现被覆盖的异常，统一给库资源加前缀是唯一彻底的解决方案。

内容的提问来源于stack exchange，提问作者K K