如何解决 NestedScrollView 只能包含一个直接子视图的错误

nestedscrollview（及 scrollview）要求其 xml 布局中**有且仅有一个直接子 view**，若在 `` 标签下并列放置多个控件（如多个 textview、linearlayout），将触发 `illegalstateexception`。正确做法是用一个根布局（如 linearlayout 或 constraintlayout）包裹所有内容。

错误原因解析

Android 的 ScrollView 及其兼容包组件 androidx.core.widget.NestedScrollView 继承自 FrameLayout，内部实现强制限制：只能添加一个直接子视图（addView() 仅允许调用一次）。当你在 <NestedScrollView> 内部直接写多个兄弟级控件（例如一个 TextView、接着一个 LinearLayout、再一个 LinearLayout），系统在解析 XML 时会逐个调用 addView()，第二次调用即抛出异常：

java.lang.IllegalStateException: ScrollView can host only one direct child

在你提供的 XML 中，<NestedScrollView> 内部存在多个同级子元素：

• <TextView android:id="@+id/tv_month_name" ... />
• <LinearLayout ... />（日期容器）
• <LinearLayout ... />（时间信息容器）
• <![CDATA[ ... ]]>（非法嵌入，也视为节点）
• 另一个 <LinearLayout ... />（底部内容）

这明显违反了“单子视图”约束。

闪念贝壳

闪念贝壳是一款AI 驱动的智能语音笔记，随时随地用语音记录你的每一个想法。

下载

正确写法：使用单一容器包裹全部内容

✅ 必须将所有子内容包裹在一个根布局中，推荐使用 LinearLayout（垂直方向）或 ConstraintLayout（更灵活）。以下是修正后的结构模板：

<androidx.core.widget.NestedScrollView
    android:id="@+id/scrollView1"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:fillViewport="true">

    <!-- ✅ 唯一且必需的直接子视图：根容器 -->
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="vertical"
        android:padding="@dimen/half_view_margin_standard">

        <!-- 所有原内容均移至此容器内 -->
        <TextView
            android:id="@+id/tv_month_name"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="center"
            android:gravity="center"
            android:paddingTop="@dimen/view_margin_standard"
            android:text="மே - திங்கள்"
            android:textColor="@color/abc_decor_view_status_guard"
            android:textSize="@dimen/app_titles_text_size"
            android:textStyle="bold" />

        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:layout_gravity="center"
            android:layout_marginTop="@dimen/half_view_margin_standard"
            android:gravity="center"
            android:orientation="horizontal">

            <TextView
                android:id="@+id/tv_date"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:fontFamily="@font/product_bold"
                android:text="08-05-2017"
                android:textColor="@color/abc_decor_view_status_guard"
                android:textSize="@dimen/app_display_type_1_text_size" />
        </LinearLayout>

        <LinearLayout
            android:layout_width="335dp"
            android:layout_height="wrap_content"
            android:layout_gravity="center"
            android:layout_marginTop="@dimen/half_view_margin_standard"
            android:layout_marginBottom="@dimen/half_view_margin_standard"
            android:orientation="horizontal">

            <TextView android:id="@+id/sf" ... />
            <TextView android:id="@+id/tv_morning" ... />
            <TextView android:id="@+id/tv_morning_time" ... />
            <TextView android:id="@+id/tv_evening" ... />
            <TextView android:id="@+id/tv_evening_time" ... />
        </LinearLayout>

        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:orientation="vertical"
            android:background="@color/card_background_color">

            <TextView android:id="@+id/tv_tamil_month_name" ... />
            <TextView android:id="@+id/tv_viratham_home" ... />
            <TextView android:id="@+id/tv_viratham_time_range" ... />
            <TextView
                android:id="@+id/tv_vishesham"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_margin="@dimen/half_view_margin_standard"
                android:gravity="center"
                android:text="காலை"
                android:textColor="@color/black"
                android:textSize="@dimen/app_body_type_1_text_size" />
        </LinearLayout>
    </LinearLayout>
</androidx.core.widget.NestedScrollView>

⚠️ 关键注意事项

• 禁止在 NestedScrollView 下直接写多个控件：即使它们逻辑上“平级”，也必须归入一个父容器。
• 避免使用 androidx.appcompat.widget.LinearLayoutCompat（非必要）：标准 LinearLayout 完全可用；LinearLayoutCompat 主要用于旧版本兼容性补丁，现代项目中无强制要求。
• fillViewport="true" 很重要：确保当内容高度不足时，NestedScrollView 仍能撑满父容器高度（尤其配合 CardView 等场景）。
• 性能提示：NestedScrollView 不支持回收子项，若列表项较多，请改用 RecyclerView + NestedScrollingChild（如 SwipeRefreshLayout + RecyclerView），而非强行嵌套长内容。
• CDATA 片段需删除：你 XML 中的 <![CDATA[ 7.00 Maalai 4.30 - 6.00"/> 是非法嵌入，既不渲染也不合法，应移除或转为注释 <!-- ... -->。

总结

修复该错误的核心原则只有一条：让 NestedScrollView 的 XML 直接子节点严格限定为 1 个布局容器。检查你的 XML，把所有原本与 NestedScrollView 并列的控件全部剪切进这个容器内——问题即刻解决。这是 Android 滚动容器的硬性设计约束，理解并遵守它，是构建稳定 UI 的基础。