商品评价

商品评价用于管理用户购买后的评分、评论、图片和商家回复。RuoYi Office 当前管理端支持评价分页、显示/隐藏、商家回复和添加虚拟评论；用户端提供可见评价分页接口，供商品详情页展示。

本页基于 ProductCommentController、AppProductCommentController、管理端 views/mall/product/comment 和 API 类型整理。

模块边界

层	路径 / 接口
管理端控制器	controller/admin/comment/ProductCommentController.java
用户端控制器	controller/app/comment/AppProductCommentController.java
服务	service/comment/ProductCommentService
管理端页面	apps/web-antd/src/views/mall/product/comment
管理端 API	apps/web-antd/src/api/mall/product/comment/index.ts
管理端接口前缀	/admin-api/product/comment
用户端接口前缀	/app-api/product/comment

管理端能力

功能	接口	权限
评价分页	GET /product/comment/page	product:comment:query
显示/隐藏评论	PUT /product/comment/update-visible	product:comment:update
商家回复	PUT /product/comment/reply	product:comment:update
添加自评/虚拟评论	POST /product/comment/create	product:comment:update

管理端列表展示商品、SKU 规格、用户昵称头像、评分、评论内容、图片、是否回复等信息。回复时使用弹窗输入回复内容，显示/隐藏会先二次确认。

用户端展示

用户端 AppProductCommentController#getCommentPage 只返回可见评价，并对匿名评价做昵称脱敏：

GET /product/comment/page

用户端通常在商品详情页展示评价列表，重点字段包括：

字段	含义
scores	总评分
descriptionScores	描述评分
benefitScores	服务评分
content	评论内容
picUrls	评论图片
replyStatus	是否已回复
replyContent	商家回复
skuProperties	SKU 规格快照

评价处理流程

当前管理端也支持创建虚拟评论，适合初始化演示数据或运营活动，但生产环境应对虚拟评论权限和标识进行严格控制。

和订单/商品的关系

评价记录关联订单、订单项、SPU、SKU 和用户信息。商品名称、SKU 规格、图片等信息需要能在订单快照或评价数据中稳定展示，避免商品后续删除或改名导致历史评价不可读。

关联对象	用途
订单	判断是否购买、是否允许评价
订单项	对应具体 SKU 和购买数量
SPU/SKU	展示商品名称、规格和图片
会员用户	展示昵称、头像，匿名时脱敏

二次开发建议

1. 增加评价审核状态时，要区分“用户端可见”和“后台审核中”。
2. 图片凭证要确认文件访问权限，避免用户端无法预览。
3. 虚拟评论建议记录创建来源，便于运营审计。
4. 回复内容需要防止 XSS，前端展示时不要直接渲染未清洗 HTML。
5. 评价统计如好评率、评分均值，建议通过异步统计或缓存避免影响列表性能。

排查清单

现象	优先检查
用户端看不到评价	visible 是否为 true，用户端分页条件是否正确
匿名昵称未脱敏	anonymous 字段和用户端转换逻辑
回复后不显示	replyStatus、replyContent、列表刷新
图片无法预览	picUrls、文件服务访问权限、跨域配置
虚拟评论创建失败	权限 product:comment:update、SPU/SKU/用户数据是否有效

下一步

• 商品基础维护请阅读 商品 SPU 与 SKU。
• SKU 规格维护请阅读 商品属性。
• 订单履约请阅读 商城交易订单。