nestedscrollview（及 scrollview）要求其 xml 布局中**有且仅有一个直接子 view**，若在 `
错误原因解析
Android 的 ScrollView 及其兼容包组件 androidx.core.widget.NestedScrollView 继承自 FrameLayout，内部实现强制限制：只能添加一个直接子视图（addView() 仅允许调用一次）。当你在
java.lang.IllegalStateException: ScrollView can host only one direct child
在你提供的 XML 中，
-
（日期容器） -
（时间信息容器） - （非法嵌入，也视为节点）
- 另一个
（底部内容）
这明显违反了“单子视图”约束。
正确写法：使用单一容器包裹全部内容
✅ 必须将所有子内容包裹在一个根布局中，推荐使用 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 中的 是非法嵌入，既不渲染也不合法，应移除或转为注释 。
总结
修复该错误的核心原则只有一条：让 NestedScrollView 的 XML 直接子节点严格限定为 1 个布局容器。检查你的 XML，把所有原本与 NestedScrollView 并列的控件全部剪切进这个容器内——问题即刻解决。这是 Android 滚动容器的硬性设计约束，理解并遵守它，是构建稳定 UI 的基础。
