Flutter集成测试如何测试pinput注册验证码输入场景

测试环境无法获取真实动态验证码、硬编码固定值无法通过校验，核心原因是测试流程走了和生产一致的动态验证码生成/校验逻辑，没有给测试场景留可控的校验入口，可按以下方案解决：

方案1：依赖注入替换Mock认证逻辑（最推荐） #

通过项目的依赖注入框架，在集成测试启动阶段替换真实的认证仓库为Mock实现，跳过真实邮件发送、动态验证码校验逻辑：

• 发送验证码接口直接模拟请求成功，不需要真实发邮件
• 验证码校验接口设置固定测试通行码，传入预设值即判定校验通过

示例Mock代码：

// 测试初始化阶段注入Mock实现
setUp(() {
  getIt.reset();
  getIt.registerSingleton<AuthRepository>(MockAuthRepository());
});

// Mock认证仓库实现
class MockAuthRepository implements AuthRepository {
  @override
  Future<Result<void>> sendEmailVerifyCode(String email) async {
    // 模拟接口请求耗时，和生产逻辑保持一致的等待时长
    await Future.delayed(const Duration(milliseconds: 500));
    return Result.success(null);
  }

  @override
  Future<Result<void>> checkEmailVerifyCode(String email, String code) async {
    // 固定测试验证码，测试时直接填这个值即可通过
    if (code == '123456') {
      return Result.success(null);
    }
    return Result.failure(AuthError.invalidVerifyCode);
  }
}

注意要给Pinput组件设置独立测试Key，确保测试脚本可以正确定位输入组件，避免输入不生效的问题：

Pinput(
  key: const Key('email_verify_code_input'),
  length: 6,
  // 其余业务配置
)

对应测试页的验证码输入方法写法：

Future<void> enterVerificationCode(String code) async {
  final codeInput = find.byKey(const Key('email_verify_code_input'));
  await tester.enterText(codeInput, code);
  await tester.pump(const Duration(milliseconds: 100));
}

调整后测试流程里直接传入预设的固定测试码123456即可正常通过校验。

方案2：对接测试环境的万能验证码配置 #

如果测试流程需要走真实后端接口，直接联系后端在测试环境配置万能验证码：所有测试环境的验证码校验请求，传入约定好的固定值（比如123456）直接判定通过，发送验证码接口不需要真的投递邮件，直接返回成功即可。这种方案不需要改前端Mock逻辑，测试环境和生产环境的代码逻辑一致性更高。

常见踩坑排查 #

如果改完逻辑还是校验失败，优先排查以下问题：

• 硬编码的测试验证码长度和Pinput配置的校验长度是否一致，比如配置6位验证码却传4位1234，会直接触发前端校验失败
• 测试输入方法是否正确定位到Pinput组件，Pinput是自定义输入组件，不要用普通TextField的查找逻辑定位，避免输入事件没有生效
• 测试环境是否误连生产环境接口，生产环境的动态验证码和你硬编码的值不匹配，自然无法通过

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