You need to enable JavaScript to run this app. React中使用react-phone-input-2出现ref属性不存在报错如何解决
优惠活动
大模型
产品
解决方案
定价
更多

React中使用react-phone-input-2出现ref属性不存在报错如何解决

报错原因

该报错本质是类型不匹配问题:react-phone-input-2 官方提供的TS类型定义中,没有将ref列为PhoneInput组件的合法顶层props,直接绑定ref就会触发类型校验失败。你可以先执行以下命令安装最新的类型声明包,排除类型定义缺失的问题:
npm i @types/react-phone-input-2 -D
如果安装后仍报相同错误,使用以下两种方案解决即可。

解决方案

方案1:通过inputProps透传ref(推荐)

PhoneInput组件原生支持inputProps配置项,所有传入该属性的字段都会直接透传给内部的原生<input>元素,不仅不会触发类型报错,拿到的ref也是真实的输入框DOM实例,符合日常开发操作需求:

import React, { ForwardedRef } from 'react';
import PhoneInput from 'react-phone-input-2';
import 'react-phone-input-2/lib/bootstrap.css'

const FormikPhoneInput = React.forwardRef(
  ({ name, country, ...rest }: {name: string, country: string}, ref: React.ForwardedRef<HTMLInputElement>) => (
    <PhoneInput 
      {...rest} 
      name={name}
      {/* 通过inputProps透传ref给内部输入框 */}
      inputProps={{ ref }}
    />
  )
);

export default FormikPhoneInput;

方案2:类型断言绕开校验(适用于特殊场景)

如果你确实需要获取PhoneInput的组件实例而非内部输入框DOM,可以通过类型断言绕开TS的类型校验:

import React, { ForwardedRef } from 'react';
import PhoneInput from 'react-phone-input-2';
import 'react-phone-input-2/lib/bootstrap.css'

const FormikPhoneInput = React.forwardRef(
  ({ name, country, ...rest }: {name: string, country: string}, ref: React.ForwardedRef<any>) => (
    <PhoneInput 
      {...rest} 
      {/* 用as断言绕开类型检查 */}
      ref={ref as any} 
      name={name}  
    />
  )
);

export default FormikPhoneInput;

注意:该方案会丢失组件实例的类型提示,仅建议在确实需要访问组件实例方法的场景下使用。

内容的提问来源于stack exchange,提问作者Tyler_coder

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.18 17:45:02