集成Twilio 2FA OTP对接Node.js后端与Flutter注册功能时报用户无效错误如何解决

报错详情 #

User was not valid

{
  email: 'is invalid',
  cellphone: 'is invalid',
  message: 'User was not valid',
  success: false,
  errors: {
    email: 'is invalid',
    cellphone: 'is invalid',
    message: 'User was not valid'
  },
  error_code: '60027'
}

核心产生原因 #

错误码60027属于参数校验失败类错误，通常在请求调用Twilio接口前或调用时触发，常见原因如下：

• 前端传参异常：Flutter端传递的手机号未携带国际区号（如国内手机号需加+86前缀）、邮箱格式不合法，或是参数键名与后端约定不匹配
• 后端校验逻辑问题：后端自定义的前置校验规则过严或正则规则错误，还未调用Twilio接口就直接拦截请求返回报错
• Twilio配置问题：当前使用的Twilio Verify服务开启了邮箱+手机号双校验，传入的参数格式不符合Twilio的官方要求

排查步骤 #

• 首先抓包查看Flutter端发起请求的实际参数，确认邮箱、手机号格式是否正确，参数键名是否与后端约定完全一致
• 后端临时注释本地参数校验逻辑，直接打印接收的参数后调用Twilio接口，若仍报错则为参数不符合Twilio要求，若恢复正常则为后端本地校验规则错误
• 登录Twilio后台查看对应Verify服务的配置，确认是否开启了多余的校验维度，是否配置了自定义参数校验规则

修复方案 #

• 端侧修复：Flutter端发送请求前对手机号统一补全国际区号，对邮箱做前端格式预校验，严格按照约定的键名传递参数
• 后端修复：调整邮箱、手机号的校验正则，增加参数格式化逻辑，避免将合法参数判定为无效
• Twilio配置修复：如果不需要同时校验邮箱和手机号，直接关闭对应校验维度即可；如果需要双校验，按照Twilio要求调整参数格式即可

内容的提问来源于stack exchange，提问作者karan singh tomar