Magento 2.4登录API中如何通过手机号获取客户ID

Magento 原生Customer模型未提供loadByPhone方法，需要根据你存储手机号的字段位置选择对应实现方式，以下是兼容你现有代码风格、同时符合Magento编码规范的实现方案：

前置说明 #

无密码OTP登录场景下，强烈建议给客户主体新增全局自定义属性mobile存储手机号，不要使用客户地址自带的telephone字段：地址字段不属于客户全局唯一属性，一个客户可关联多个地址、存在多个电话，会出现匹配冲突问题。

实现方式1：兼容你现有factory调用的写法 #

和你之前用loadByEmail的代码风格完全一致，可直接替换使用：

$mobile = "用户传入的待校验手机号";
// 第二个参数替换为你实际使用的手机号属性code，如果你自定义的属性名是phone就填'phone'
$customer = $this->customerFactory->create();
$customer->load($mobile, 'mobile');
$customerId = $customer->getId();

注意：该写法在Magento 2.4+版本中被标记为不推荐，直接按非主键属性加载模型会触发全表属性查询，性能较差，正式项目建议使用下方符合规范的Repository写法。

实现方式2：符合Magento官方编码规范的写法（推荐） #

首先在类的构造函数中注入两个必要依赖，替换你原有直接依赖customerFactory的逻辑：

public function __construct(
    \Magento\Customer\Api\CustomerRepositoryInterface $customerRepository,
    \Magento\Framework\Api\SearchCriteriaBuilder $searchCriteriaBuilder
) {
    $this->customerRepository = $customerRepository;
    $this->searchCriteriaBuilder = $searchCriteriaBuilder;
}

封装通过手机号获取客户ID的方法：

/**
 * 通过手机号查询匹配的客户ID
 * @param string $mobile 格式统一后的手机号
 * @return int|null 未匹配到客户返回null
 */
public function getCustomerIdByPhone(string $mobile): ?int
{
    // 按手机号属性做等值查询，每次只取1条结果
    $this->searchCriteriaBuilder->addFilter('mobile', trim($mobile), 'eq');
    $searchCriteria = $this->searchCriteriaBuilder->create()->setPageSize(1);
    $searchResult = $this->customerRepository->getList($searchCriteria);

    if ($searchResult->getTotalCount() === 0) {
        return null;
    }

    $matchedCustomers = $searchResult->getItems();
    return array_pop($matchedCustomers)->getId();
}

开发注意事项 #

• 查询前必须统一手机号格式：去掉国家码前缀、空格、横杠等特殊字符，和数据库存储的格式保持一致，避免因格式问题匹配失败
• 必须给手机号发送OTP的接口加频率限制，避免被恶意利用发送垃圾短信
• 只有OTP验证码校验通过后，才能用拿到的$customerId生成登录授权token

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