PhoneNumberFormattingTextWatcher处理11开头号码不格式化问题排查

我之前也碰到过类似的坑，咱们来一步步拆解原因和解决办法：

问题根源 #

默认的PhoneNumberFormattingTextWatcher底层依赖Google的libphonenumber库，它的格式化逻辑非常严谨——只有当输入的号码片段能被解析为当前地区的有效电话号码时，才会触发格式化规则。

针对美国地区（国家代码为1）：

• 合法的号码结构是「国家代码1 + 10位本地号码」，总长度11位数字，格式化后为1 222-222-2222
• 当你输入连续的1（比如超过11位，或者输入过程中还没凑齐11位有效数字时），libphonenumber无法将其识别为合规的美国手机号，所以会直接跳过格式化，把输入当作普通字符串处理。

另外，默认Watcher没有提供可配置的入口来放宽这种校验逻辑，所以只能通过自定义实现来解决。

解决办法：自定义手机号格式化Watcher #

我们可以直接基于libphonenumber库封装一个自定义的TextWatcher，手动控制格式化逻辑，只要输入的数字能匹配美国号码的结构就应用格式化。

步骤1：引入libphonenumber库 #

首先在你的build.gradle中添加依赖：

implementation 'com.googlecode.libphonenumber:libphonenumber:8.12.53'

步骤2：实现自定义TextWatcher #

import android.text.Editable;
import android.text.TextWatcher;
import android.widget.EditText;
import com.google.i18n.phonenumbers.NumberParseException;
import com.google.i18n.phonenumbers.PhoneNumberUtil;
import com.google.i18n.phonenumbers.Phonenumber;

public class USPhoneFormatWatcher implements TextWatcher {
    private final EditText targetEditText;
    private final PhoneNumberUtil phoneNumberUtil;
    private boolean isFormattingInProgress;

    public USPhoneFormatWatcher(EditText editText) {
        this.targetEditText = editText;
        this.phoneNumberUtil = PhoneNumberUtil.getInstance();
        this.isFormattingInProgress = false;
    }

    @Override
    public void beforeTextChanged(CharSequence s, int start, int count, int after) {}

    @Override
    public void onTextChanged(CharSequence s, int start, int before, int count) {}

    @Override
    public void afterTextChanged(Editable s) {
        // 避免递归触发格式化
        if (isFormattingInProgress) {
            return;
        }
        isFormattingInProgress = true;

        // 先移除所有非数字字符
        String rawInput = s.toString().replaceAll("[^\\d]", "");
        try {
            // 解析为美国手机号
            Phonenumber.PhoneNumber phoneNumber = phoneNumberUtil.parse(rawInput, "US");
            // 格式化为美国本地号码样式
            String formattedNumber = phoneNumberUtil.format(phoneNumber, PhoneNumberUtil.PhoneNumberFormat.NATIONAL);
            // 更新EditText内容
            s.replace(0, s.length(), formattedNumber);
        } catch (NumberParseException e) {
            // 解析失败时，保持原输入（也可以根据需求提示用户输入无效）
        }

        isFormattingInProgress = false;
    }
}

步骤3：给EditText设置自定义Watcher #

替换原来的默认Watcher即可：

etMobile.addTextChangedListener(new USPhoneFormatWatcher(etMobile));

额外优化建议 #

• 保持EditText的inputType="phone"不变，同时maxLength="14"的设置是合理的（对应格式化后1 222-222-2222的长度）
• 如果需要处理超长输入的情况，可以在自定义Watcher里对rawInput做截断，比如只保留前11位数字，避免解析失败

内容的提问来源于stack exchange，提问作者Oto-obong Eshiett