BottomSheetBehavior异常排查：视图非CoordinatorLayout子视图报错

嘿，我之前也踩过这个坑！明明看着布局已经是CoordinatorLayout的子视图了，结果还是弹出这个报错，给你几个实用的排查方向和解决办法：

1. 确保BottomSheet是CoordinatorLayout的直接子View #

BottomSheetBehavior有个硬性要求：目标View必须是CoordinatorLayout的直接子元素，绝对不能嵌套在其他容器（比如FrameLayout、RelativeLayout）里面。

举个反例，这种写法肯定会报错：

<androidx.coordinatorlayout.widget.CoordinatorLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- 嵌套了FrameLayout，BottomSheet不是直接子View -->
    <FrameLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <LinearLayout
            android:id="@+id/bottom_sheet"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            app:layout_behavior="com.google.android.material.bottomsheet.BottomSheetBehavior"/>
    </FrameLayout>

</androidx.coordinatorlayout.widget.CoordinatorLayout>

正确的写法应该是把BottomSheet直接放在CoordinatorLayout下：

<androidx.coordinatorlayout.widget.CoordinatorLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- 直接作为CoordinatorLayout的子View -->
    <LinearLayout
        android:id="@+id/bottom_sheet"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:layout_behavior="com.google.android.material.bottomsheet.BottomSheetBehavior">
        
        <!-- 这里放你的BottomSheet内容 -->
    </LinearLayout>

</androidx.coordinatorlayout.widget.CoordinatorLayout>

2. 检查代码中获取BottomSheetBehavior的方式 #

如果布局没问题，那大概率是代码里找错了View。比如你不小心拿到了BottomSheet的父容器，或者用错了View ID，都会触发这个错误。

错误示例：

// 误拿了CoordinatorLayout本身或者嵌套的父容器
val wrongView = findViewById<View>(R.id.coordinator_layout)
val behavior = BottomSheetBehavior.from(wrongView) // 这里必报错！

正确示例：

// 一定要拿到BottomSheet本身的View
val bottomSheet = findViewById<LinearLayout>(R.id.bottom_sheet)
val behavior = BottomSheetBehavior.from(bottomSheet)

// 或者用Kotlin扩展语法更简洁
val behavior = bottomSheet.bottomSheetBehavior

3. 升级Material Components依赖库 #

如果你的Material库版本比较旧，可能存在一些兼容性bug。建议升级到最新的稳定版，比如在build.gradle（Module级别）里修改：

implementation 'com.google.android.material:material:1.9.0' // 可以换成当前最新稳定版

4. 动态Inflate布局时避免嵌套 #

如果是动态加载BottomSheet布局，要确保Inflate时直接把它添加到CoordinatorLayout中，不要先放到其他容器再嵌套进去。

错误示例：

// 先把BottomSheet加到FrameLayout，再把FrameLayout加到CoordinatorLayout
val bottomSheetView = LayoutInflater.from(context).inflate(R.layout.bottom_sheet, someFrameLayout, true)
coordinatorLayout.addView(someFrameLayout)

正确示例：

// 直接Inflate到CoordinatorLayout（最后一个参数传false，手动添加）
val bottomSheetView = LayoutInflater.from(context).inflate(R.layout.bottom_sheet, coordinatorLayout, false)
coordinatorLayout.addView(bottomSheetView)

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