Flutter 软键盘弹出时TextField无法自动上滑滚动问题求助

软键盘弹出时输入框无法自动滚动避让的核心原因是你在Scaffold中配置了resizeToAvoidBottomInset: false。该配置会禁止Scaffold在软键盘弹出时重新计算自身可用高度，外层包裹的SingleChildScrollView无法感知软键盘占用的屏幕空间，自然不会触发滚动调整。

基础修复方案（常规场景） #

直接移除Scaffold上的resizeToAvoidBottomInset: false配置即可，该属性默认值为true，移除后Scaffold会自动随软键盘弹出调整视口高度，配合SingleChildScrollView就能实现输入框自动滚动避让。

场景适配方案（需固定页面背景/布局不随键盘缩放） #

如果你是为了固定顶部背景图不随键盘上移才设置resizeToAvoidBottomInset: false，不需要修改该配置，只需要给SingleChildScrollView补充响应式底部内边距，自动适配软键盘高度即可。

修正后的完整页面代码如下：

return Scaffold(
  // 如需固定背景可保留此行，否则直接删除
  resizeToAvoidBottomInset: false,
  body: SingleChildScrollView(
    physics: const ClampingScrollPhysics(),
    // 核心：自动获取软键盘高度，给滚动区域预留底部避让空间
    padding: EdgeInsets.only(
      bottom: MediaQuery.of(context).viewInsets.bottom + 20
    ),
    child: Column(
      crossAxisAlignment: CrossAxisAlignment.start,
      children: [
        Container(
          height: MediaQuery.of(context).size.height / 2.5,
          child: Stack(
            alignment: Alignment.center,
            // 替换已废弃的Overflow.visible
            clipBehavior: Clip.none,
            children: [
              Positioned(
                top: MediaQuery.of(context).size.height * 0.001 * -5,
                right: 0,
                child: Container(
                  width: MediaQuery.of(context).size.width * 1.1,
                  height: MediaQuery.of(context).size.height * 0.45,
                  decoration: const BoxDecoration(
                    image: DecorationImage(
                      fit: BoxFit.fill,
                      image: AssetImage('assets/slide3.png'),
                    ),
                  ),
                ),
              ),
            ],
          ),
        ),
        SizedBox(height: MediaQuery.of(context).size.height * 1 / 20),
        Padding(
          padding:
              const EdgeInsets.symmetric(vertical: 16.0, horizontal: 20),
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              Text(
                'Create an Account',
                style: GoogleFonts.workSans(
                    color: Colors.black,
                    fontSize: 23,
                    fontWeight: FontWeight.w500),
              ),
              const SizedBox(height: 15),
              Text(
                'Create an account to continue an awesome experience',
                style: GoogleFonts.workSans(color: Colors.black),
              ),
              const SizedBox(height: 16),
              InputWidget(
                height: MediaQuery.of(context).size.height / 13,
                controller: _usernameController,
                label: 'Username',
                hint: 'johndoe',
              ),
              const SizedBox(height: 16),
              InputWidget(
                height: MediaQuery.of(context).size.height / 13,
                controller: _emailController,
                label: 'Email Address',
                hint: 'johndoe@email.com',
              ),
              const SizedBox(height: 16),
              InputWidget(
                height: MediaQuery.of(context).size.height / 13,
                controller: _passwordController,
                label: 'Password',
                isObscure: true,
              ),
              SizedBox(
                height: MediaQuery.of(context).size.height / 20,
              ),
              Center(
                // 移除多余嵌套的外层InkWell，避免跳转逻辑覆盖注册方法
                child: InkWell(
                  onTap: signUpUser,
                  child: Container(
                    width: double.infinity,
                    height: MediaQuery.of(context).size.height / 13,
                    decoration: BoxDecoration(
                      color: primaryColor,
                      borderRadius: BorderRadius.circular(5),
                    ),
                    child: Center(
                      child: _isLoading
                          ? const CircularProgressIndicator(
                              color: Colors.white,
                            )
                          : const Text(
                              'Create Account',
                              style: TextStyle(color: Colors.white),
                            ),
                    ),
                  ),
                ),
              ),
              const SizedBox(height: 20),
              InkWell(
                onTap: () {
                  Get.to(() => LoginPage());
                },
                child: RichText(
                    text: TextSpan(
                  text: 'Already have an account? ',
                  style: GoogleFonts.workSans(color: Colors.black),
                  children: [
                    TextSpan(
                      text: 'Login',
                      style: GoogleFonts.workSans(
                        color: primaryColor,
                        fontWeight: FontWeight.bold,
                      ),
                    ),
                  ],
                )),
              ),
              // 额外底部间距，避免最后一个输入框聚焦时被按钮遮挡
              const SizedBox(height: 40),
            ],
          ),
        ),
      ],
    ),
  ),
);

• 原代码中Overflow.visible属于已废弃API，替换为clipBehavior: Clip.none即可兼容新版本Flutter。
• 注册按钮位置嵌套了两层InkWell，外层写的跳转到主页的逻辑会覆盖内层的注册方法，直接删除多余的外层InkWell即可。
• 原代码中大量固定值组件未加const修饰，补充后可以减少不必要的组件重建，提升页面性能。

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