如何修复Twilio OTP API调用中的参数无效错误？

常见原因及修复方案 #

1. 请求参数格式错误（最常见） #

Twilio Verify API 不接受JSON格式的请求体，它要求使用application/x-www-form-urlencoded编码的表单数据。你的Axios代码直接传入JSON对象，会导致参数无法被正确解析，触发无效参数错误。

修复方法：
使用qs库序列化参数，同时指定正确的请求头：

import axios from 'axios';
import qs from 'qs'; // 先安装依赖：npm install qs

const accountSid = 'your_account_sid';
const authToken = 'your_auth_token';
const serviceSid = 'your_verify_service_sid';

export default {
  methods: {
    async generateSmsOtp(phoneNumber) {
      const response = await axios.post(
        `https://verify.twilio.com/v2/Services/${serviceSid}/Verifications`,
        qs.stringify({
          To: phoneNumber,
          Channel: 'sms',
        }),
        {
          auth: {
            username: accountSid,
            password: authToken,
          },
          headers: {
            'Content-Type': 'application/x-www-form-urlencoded',
          },
        }
      );

      return response.data.sid;
    },
  },
};

2. 电话号码格式不符合E.164标准 #

Twilio要求To参数必须严格遵循E.164格式：

• 以+开头，后跟国家代码和手机号（例如中国号码为+8613xxxxxxxxx）
• 不能包含空格、括号、短横线等特殊字符

如果传入的是不带国家代码的纯手机号（如13xxxxxxxxx），或格式不规范，会直接触发参数错误。

3. Service SID/认证信息错误 #

• 确认serviceSid是Twilio Verify服务的SID，而非其他服务（如短信服务）的SID
• 检查accountSid和authToken是否与Twilio控制台信息完全一致，避免多余空格或拼写错误

4. PHP代码的对应修复（针对PHP调用也报错的情况） #

PHP调用报错大概率也是上述格式或号码问题，以下是Guzzle库的修复示例：

<?php
require 'vendor/autoload.php';
use GuzzleHttp\Client;

$accountSid = 'your_account_sid';
$authToken = 'your_auth_token';
$serviceSid = 'your_verify_service_sid';
$phoneNumber = '+8613xxxxxxxxx';

$client = new Client();
$response = $client->post("https://verify.twilio.com/v2/Services/$serviceSid/Verifications", [
    'auth' => [$accountSid, $authToken],
    'form_params' => [
        'To' => $phoneNumber,
        'Channel' => 'sms'
    ]
]);

echo $response->getBody();
?>

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