组件 Props 类型不匹配
快速摘要
你传递了错误类型的 prop —— 组件期望函数但得到对象,或期望字符串但得到数字。
为什么发生
父组件传递的值类型与组件期望的不同(如字符串而非数字)
可选 prop 未传递且组件未处理 undefined 情况
回调 prop 传递了值而非函数,或相反
最小示例
✗ 错误代码
function Price({ value, currency }) {
return <span>{value.toFixed(2)} {currency}</span>;
}
// Parent passes string instead of number
<Price value='99.99' currency='USD' /> // value.toFixed is not a function✓ 修复代码
function Price({ value, currency }) {
return <span>{Number(value).toFixed(2)} {currency}</span>;
}
<Price value='99.99' currency='USD' /> // converts to number first在组件内将值转为数字确保 toFixed 始终可用,无论传递的 prop 类型如何。
如何诊断
使用 TypeScript 或 PropTypes 在构建时或运行时捕获类型不匹配
在组件内记录 props 检查运行时的实际类型
查看组件的 prop 文档或类型定义了解期望类型
如何修复
从父组件传递正确类型:用 String()、Number() 转换值或包装为函数
为可选 prop 添加默认值使组件优雅处理 undefined
用 TypeScript 接口或 PropTypes 定义并强制执行期望的 prop 类型
如何预防
用 TypeScript 或 PropTypes 定义 prop 类型并启用严格类型检查
记录期望的 prop 类型并为可选 prop 提供默认值