Android Kotlin开发：软键盘弹出时布局上移失效求助

问题背景 #

使用Kotlin开发Android应用，需要实现软键盘弹出时屏幕自动上移，避免输入框等界面元素被遮挡。布局仅使用FrameLayout和ConstraintLayout，已在AndroidManifest及代码中配置android:windowSoftInputMode="adjustResize"，但设置无效。

提供的布局代码 #

Fragment布局（fragment_sign_in.xml） #

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:id="@+id/main"
    tools:context=".SignInFragment">
        <androidx.constraintlayout.widget.ConstraintLayout
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:background="@color/main_color">

            <androidx.constraintlayout.widget.ConstraintLayout
                android:id="@+id/bg_intro"
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                app:layout_constraintStart_toStartOf="parent"
                app:layout_constraintTop_toTopOf="parent">

                <androidx.constraintlayout.widget.ConstraintLayout
                        android:layout_width="match_parent"
                        android:layout_height="match_parent">

                        <ImageView
                            android:id="@+id/iv_intro_image"
                            android:layout_width="match_parent"
                            android:layout_height="0dp"
                            android:src="@drawable/intro_pic"
                            android:scaleType="center"
                            app:layout_constraintStart_toStartOf="parent"
                            app:layout_constraintTop_toTopOf="parent"
                            app:layout_constraintEnd_toEndOf="parent"
                            app:layout_constraintHeight_percent="0.3"/>

                        <ImageView
                            android:id="@+id/iv_intro_image2"
                            android:layout_width="match_parent"
                            android:layout_height="100dp"
                            android:src="@drawable/gradient_background"
                            app:layout_constraintBottom_toBottomOf="@id/iv_intro_image"
                            app:layout_constraintEnd_toEndOf="parent"
                            app:layout_constraintStart_toStartOf="parent"/>

                        <androidx.constraintlayout.widget.ConstraintLayout
                            android:layout_width="match_parent"
                            android:layout_height="wrap_content"
                            android:orientation="vertical"
                            app:layout_constraintStart_toStartOf="parent"
                            app:layout_constraintTop_toBottomOf="@id/iv_intro_image2"
                            android:layout_marginStart="24dp"
                            android:layout_marginEnd="24dp">

                            <TextView
                                android:id="@+id/tv_login"
                                android:layout_width="match_parent"
                                android:layout_height="wrap_content"
                                android:text="Log In"
                                android:textSize="30sp"
                                android:textColor="@color/orange"
                                android:textAlignment="center"
                                android:textStyle="bold"
                                app:layout_constraintTop_toTopOf="parent"/>

                            <EditText
                                android:id="@+id/et_username_or_email"
                                android:layout_width="match_parent"
                                android:layout_height="70dp"
                                android:autofillHints=""
                                android:hint="username or email"
                                android:ems="8"
                                android:background="@drawable/edittext_bg"
                                android:textColorHint="@color/white"
                                android:textColor="@color/white"
                                android:inputType="text"
                                android:layout_marginTop="40dp"
                                android:padding="20dp"
                                app:layout_constraintTop_toBottomOf="@id/tv_login"/>

                            <EditText
                                android:id="@+id/password"
                                android:layout_width="match_parent"
                                android:layout_height="70dp"
                                android:hint="password"
                                android:ems="8"
                                android:background="@drawable/edittext_bg"
                                android:textColorHint="@color/white"
                                android:textColor="@color/white"
                                android:inputType="textPassword"
                                android:layout_marginTop="20dp"
                                android:padding="20dp"
                                app:layout_constraintTop_toBottomOf="@id/et_username_or_email"/>

                            <androidx.constraintlayout.widget.ConstraintLayout
                                android:id="@+id/layout_forgot_password"
                                android:layout_width="match_parent"
                                android:layout_height="wrap_content"
                                android:layout_marginTop="15dp"
                                app:layout_constraintTop_toBottomOf="@id/password">

                                <TextView
                                    android:layout_width="wrap_content"
                                    android:layout_height="wrap_content"
                                    android:text="Forgot Password?"
                                    android:textColor="@color/white"
                                    app:layout_constraintTop_toTopOf="parent"
                                    app:layout_constraintStart_toStartOf="parent"/>

                                <TextView
                                    android:layout_width="wrap_content"
                                    android:layout_height="wrap_content"
                                    android:text="Don't have an account?"
                                    android:textColor="@color/white"
                                    app:layout_constraintTop_toTopOf="parent"
                                    app:layout_constraintEnd_toEndOf="parent"/>

                            </androidx.constraintlayout.widget.ConstraintLayout>

                            <androidx.appcompat.widget.AppCompatButton
                                android:layout_width="match_parent"
                                android:layout_height="wrap_content"
                                android:layout_marginTop="30dp"
                                android:layout_marginBottom="30dp"
                                android:text="Log In"
                                android:background="@drawable/button_bg"
                                app:layout_constraintTop_toBottomOf="@id/layout_forgot_password"/>

                        </androidx.constraintlayout.widget.ConstraintLayout>

                    </androidx.constraintlayout.widget.ConstraintLayout>

            </androidx.constraintlayout.widget.ConstraintLayout>

        </androidx.constraintlayout.widget.ConstraintLayout>

</FrameLayout>

Activity布局（activity_authentication.xml） #

<layout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    tools:context=".AuthenticationActivity">

    <FrameLayout
        android:id="@+id/main"
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <androidx.fragment.app.FragmentContainerView
            android:id="@+id/fragment_container_view"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:name="com.example.app.SignInFragment"
            tools:layout="@layout/fragment_sign_in" />
    </FrameLayout>

</layout>

排查与解决步骤 #

1. 检查全屏/沉浸式设置干扰
   如果Activity启用了全屏或沉浸式模式（如设置SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN），adjustResize会失效。需添加SYSTEM_UI_FLAG_LAYOUT_STABLE配合：

window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_LAYOUT_STABLE or View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN

同时确保主题中未设置android:windowTranslucentStatus=true或android:windowFullscreen=true，这类属性会阻断窗口 resize 逻辑。

2. 添加fitsSystemWindows属性
   在Fragment的最外层FrameLayout添加android:fitsSystemWindows="true"，让布局响应系统窗口（包括软键盘）的尺寸变化：

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    ...
    android:fitsSystemWindows="true"
    ...>

3. 替换adjustResize为adjustPan
   若adjustResize仍无效，可尝试使用adjustPan，它会直接平移整个界面确保焦点元素可见：
   在AndroidManifest中修改：

android:windowSoftInputMode="adjustPan"

或代码中设置：

window.setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_PAN)

4. 简化布局层级并添加滚动容器
   当前布局嵌套过多ConstraintLayout，可能导致布局无法正确响应窗口变化。可将输入区域包裹在ScrollView中，确保软键盘弹出时可滚动查看内容：

<ScrollView
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fillViewport="true">
    <!-- 原输入区域的ConstraintLayout内容 -->
</ScrollView>

android:fillViewport="true"需添加，保证ScrollView填充父布局空间。

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