Review 的 ratingValue 用了中文数字 校验报错

这类问题我又碰上了一次。商品评价模块把评分渲染成了「四分半」，结构化数据里直接写进了 ratingValue。GSC 报类型错误，星级富媒体全部不展示。

第一反应是「reviewCount 与实际评价条数不一致，被判不可信」，验证下来不成立。

这类报错背后常见的原因有几处，逐个排除就行。ratingValue 必须是数字或数字字符串，中文描述不被接受；bestRating 没写，默认按 5 算，实际用的是 10 分制；同页多个 Review 缺少 itemReviewed，归不到商品上。

上来先查看当前输出的评分字段

curl -s https://www.example.com/p/1024 | grep -o '"ratingValue"[^,]*'

接着改成纯数字并补 bestRating

"ratingValue": "4.5", "bestRating": "5"

随后核对评价条数与页面显示

curl -s https://www.example.com/p/1024 | grep -o '共[0-9]*条评价'

剩下的就是用测试工具复验

python validate_schema.py https://www.example.com/p/1024 --type Product

恢复的判定其实很直接。富媒体报告里的类型错误清零，三周后部分商品页开始出现星级，点击率有稳定提升。

这里还有个坑。评分字段要机器可读，中文描述、全角数字、带单位的字符串都会失败，渲染层与标记层必须分开取值。如果同一现象隔几天又出现，说明根因没找到，别当偶发处理。