Clerk Expo报错422：email_code不符合strategy参数允许值

错误问题 #

调用prepareEmailAddressVerification并传入strategy: "email_code"时触发422错误，提示email_code does not match one of the allowed values for parameter strategy，错误详情：

{
  "status": 422,
  "clerkError": true,
  "errors": [
    {
      "code": "form_param_value_invalid",
      "message": "is invalid",
      "longMessage": "email_code does not match one of the allowed values for parameter strategy",
      "meta": {
        "paramName": "strategy"
      }
    }
  ]
}

排查与解决步骤 #

1. 核查Clerk控制台验证策略配置 #

进入Clerk后台的Authentication > Email, Phone, Username页面，找到Email模块的Verification methods选项：

• 必须勾选Code选项，确保邮箱验证码验证方式已启用
• 如果仅勾选了Link，则email_code会被判定为无效策略，触发422错误

2. 确认SDK版本与参数正确性 #

• 升级@clerk/clerk-expo到最新版本，旧版本可能存在参数值兼容问题：

  npm update @clerk/clerk-expo
  # 或 yarn upgrade @clerk/clerk-expo
  

• 检查strategy参数拼写：有效值仅为email_code和email_link，确保无拼写错误（如emailcode或code都是无效值）

3. 验证SignUp实例状态 #

在调用prepareEmailAddressVerification前，确认signUp实例处于needs_verification状态：

await signUp.create({ emailAddress, password });
console.log('SignUp 当前状态:', signUp.status);
// 若输出不是needs_verification，需排查signUp.create是否执行成功
await signUp.prepareEmailAddressVerification({ strategy: "email_code" });

4. 备选方案：省略strategy参数 #

如果控制台已配置默认验证策略，可尝试省略参数，让Clerk自动匹配控制台设置：

await signUp.prepareEmailAddressVerification();

附用户相关代码 #

认证函数 #

const onSignUpPress = async () => {
    if (!isLoaded) {
      return;
    }

    try {
      await signUp.create({
        emailAddress,
        password,
      });
      await signUp.prepareEmailAddressVerification({ strategy: "email_code" });
      setPendingVerification(true);
    } catch (err) {
      setErrorList(err?.errors);
      console.error(JSON.stringify(err, null, 2));
    }
  };

  const onPressVerify = async () => {
    if (!isLoaded) {
      return;
    }

    try {
      const completeSignUp = await signUp.attemptEmailAddressVerification({
        code,
      });

      if (completeSignUp.status === 'complete') {
        await setActive({ session: completeSignUp.createdSessionId });
        router.replace('/');
      } else {
        console.error(JSON.stringify(completeSignUp, null, 2));
      }
    } catch (err) {
      console.error(JSON.stringify(err, null, 2));
    }
  };

注册视图 #

{!showLogin && 
      <View style={styles.subContainer}>
      {!pendingVerification && (
        <>
          <TextInput
            style={styles.input}
            autoCapitalize="none"
            value={emailAddress}
            placeholder="Email..."
            onChangeText={(email) => setEmailAddress(email)}
          />
          {errorList.map((error, index) => 
            error.meta.paramName === 'email_address' && (
              <Text key={index} style={styles.errorText}>{error.message}</Text>
            )
          )}
          <TextInput
            style={styles.input}
            value={password}
            placeholder="Password..."
            secureTextEntry={true}
            onChangeText={(password) => setPassword(password)}
          />
          {errorList.map((error, index) => 
            error.meta.paramName === 'password' && (
              <Text key={index} style={styles.errorText}>{error.message}</Text>
            )
          )}
          <Button style={styles.button} title="Sign Up" onPress={onSignUpPress} />
        </>
      )}
      {pendingVerification && (
        <>
          <TextInput
            value={code}
            placeholder="Code..."
            onChangeText={(code) => setCode(code)}
          />
          <Button title="Verify Email" onPress={onPressVerify} />
        </>
      )}
        <View>
          <Text>Already have an account?</Text>
           
          <TouchableOpacity style={styles.pillButton} onPress={()=>setShowLogin(true)}>
            <Text style={styles.pillButtonText}>Log In</Text>
          </TouchableOpacity>
        </View>
      </View>}

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