## 一、前言

在之前的系列文章中，我写了 LikeShop 多商户版的订单状态机、分账对接、商品模块和连锁点餐系统。这一篇聚焦评价体系——电商系统中直接影响转化率、但二开时最容易被低估的模块。

先说一个多商户场景下的典型问题。有运营反馈，平台上某个商家的商品评价区全是“好评”，用户根本看不到真实的差评，转化率反而越来越低。排查后发现，商家在后台可以自由控制评价的显示和隐藏，把所有差评都藏掉了。用户不傻，看不到负面评价反而更不信任，最后直接流失。

这个问题的根源在于**多商户版的评价权限设计**。LikeShop 多商户版的评价体系有一个核心设计原则：**商家可以对评价进行回复，但评价的显示、隐藏和删除权限只归平台所有**。评价的显示、隐藏和删除权限之所以不开放给商家，是因为商家容易控制评论，从而无法真实反应商品质量，可能导致劣币驱逐良币的后果。

理解这个权限边界，是评价体系二开的前提。这篇文章就从评价表结构出发，把晒单、追评和商家回复三条线的实现逻辑拆开讲清楚。

## 二、评价体系的表结构拆解

### 2.1 ls_goods_comment 评价主表

LikeShop 的商品评价数据存储在 `ls_goods_comment` 表中，该表通过 `order_goods_id` 关联订单商品项，确保只有购买过的用户才能评价。核心字段如下：

| 字段名 | 数据类型 | 说明 |
|--------|----------|------|
| id | int | 评价id |
| order_goods_id | int | 订单商品项id（关联已购买商品） |
| user_id | int | 用户id |
| goods_id | int | 商品id |
| shop_id | int | 商户id |
| goods_comment | tinyint | 商品评分（1-5星） |
| service_comment | tinyint | 服务评分（1-5星） |
| express_comment | tinyint | 物流评分（1-5星） |
| description_comment | tinyint | 描述相符评分（1-5星） |
| comment | varchar | 评价内容 |
| image | varchar | 评价图片（JSON数组） |
| reply | varchar | 商家回复 |
| is_anonymous | tinyint | 是否匿名：0-否；1-是 |
| status | tinyint | 审核状态：0-待审核；1-审核通过；2-审核拒绝 |
| create_time | int | 评价时间 |
| delete_time | int | 删除时间 |

**`order_goods_id` 是评价体系的根基**。它确保只有真正购买过该商品的用户才能发表评价，杜绝了刷评的可能性。

### 2.2 评价的四个评分维度

LikeShop 的评价体系包含四个评分维度：**商品评分**（`goods_comment`）、**服务评分**（`service_comment`）、**物流评分**（`express_comment`）和**描述相符评分**（`description_comment`）。

这四个维度在评价列表中分别展示，商品详情页的“好评率”是根据 `goods_comment` 维度计算的。

### 2.3 评价状态与审核机制

原生系统已具备基础评价审核能力。后台商品评价管理页面支持通过商品名称、用户昵称、评价类型、回复状态、审核状态、评价时间等条件搜索筛选评价。

在“通用设置”中可以配置“开启后会有评论（首次评价、追评）需要后台审核后才能在前端显示”，审核状态控制评价是否对外展示。**真实评价只有审核成功之后的评论才会展示在商品详情的评论区中，虚拟评价不需要审核即可展示**。

### 2.4 评价列表接口

评价列表接口为 `api/goods_comment/lists`，请求参数中 `id` 选填（0全部、1返图、2好评、3中评、4差评），`goods_id` 必填。

返回的核心字段包括：`goods_comment`（商品星级）、`service_comment`（服务星级）、`express_comment`（物流星级）、`comment`（评价内容）、`image`（图片数组）、`reply`（商家回复）、`nickname`/`avatar`（用户信息）、`create_time`（评价时间）。

## 三、晒单功能的实现

### 3.1 图片上传的处理流程

晒单的核心是评价图片的上传和存储。用户提交评价时，图片上传是一个耗时操作，**必须异步处理**，不能阻塞评价写入。

完整的晒单流程如下：

```
用户选择图片 → 前端压缩 → 调用上传接口 → 图片异步上传到存储
    ↓
评价记录写入 ls_goods_comment（image 字段存图片路径的 JSON 数组）
    ↓
后台审核状态控制前端展示
    ↓
评价列表接口返回 image 数组
    ↓
商品详情页渲染评价卡片
```

### 3.2 图片存储的字段设计

`image` 字段存储的是图片路径的 JSON 数组。在存储到数据库之前，需要先通过上传接口把图片上传到服务器或对象存储，拿到路径后再写入评价记录。

```php
// server/app/shopapi/logic/CommentLogic.php
class CommentLogic
{
    /**
     * 提交商品评价（带晒图）
     */
    public static function add(array $params, int $userId): int
    {
        // 1. 校验订单商品是否属于该用户
        $orderGoods = OrderGoodsModel::alias('og')
            ->join('order o', 'og.order_id = o.id')
            ->where('og.id', $params['order_goods_id'])
            ->where('o.user_id', $userId)
            ->find();

        if (!$orderGoods) {
            throw new Exception('订单商品不存在或无权评价');
        }

        // 2. 校验是否已评价过
        $exists = CommentModel::where('order_goods_id', $params['order_goods_id'])
            ->where('delete_time', 0)
            ->find();
        if ($exists) {
            throw new Exception('该商品已评价，请勿重复评价');
        }

        // 3. 处理图片数组（路径已在异步上传阶段获取）
        $imageArr = $params['image'] ?? [];

        // 4. 写入评价记录
        $commentId = CommentModel::create([
            'order_goods_id'      => $params['order_goods_id'],
            'user_id'             => $userId,
            'goods_id'            => $orderGoods['goods_id'],
            'shop_id'             => $orderGoods['shop_id'],
            'goods_comment'       => $params['goods_comment'],
            'service_comment'     => $params['service_comment'],
            'express_comment'     => $params['express_comment'],
            'description_comment' => $params['description_comment'],
            'comment'             => $params['comment'] ?? '',
            'image'               => json_encode($imageArr, JSON_UNESCAPED_UNICODE),
            'is_anonymous'        => $params['is_anonymous'] ?? 0,
            'status'              => 0, // 待审核
            'create_time'         => time(),
        ])->id;

        return $commentId;
    }
}
```

### 3.3 晒图审核的实现

**原生系统的审核状态是评价级别的开关**（整条评价审核通过/驳回），无法针对单张图片进行精细审核。如果业务需要更细粒度的审核，二开时可以增加一个图片审核表：

```sql
CREATE TABLE `ls_comment_image_audit` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `comment_id` int(11) NOT NULL COMMENT '评价id',
  `image_url` varchar(500) NOT NULL COMMENT '图片路径',
  `audit_status` tinyint(1) DEFAULT '0' COMMENT '0-待审核;1-通过;2-拒绝',
  `audit_remark` varchar(255) DEFAULT '' COMMENT '审核备注',
  `create_time` int(11) NOT NULL DEFAULT '0',
  PRIMARY KEY (`id`),
  KEY `idx_comment` (`comment_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='评价图片审核表';
```

审核通过后，只有 `audit_status = 1` 的图片才会在评价列表中返回给前端。

### 3.4 后台审核配置

在后台的「通用设置」中，可以配置评价是否需要审核。开启后，**首次评价和追评都需要后台审核后才能在前端显示**。

后台商品评价管理页面支持按商品名称、用户昵称、评价类型、回复状态、审核状态、评价时间等条件筛选评价。

## 四、追评功能的实现

### 4.1 追评的业务约束

追评的核心业务约束是：**用户必须在收货后的一定时间窗口内进行追评**。时间窗口过短，用户来不及体验商品；时间窗口过长，追评与初始评价的时间间隔过大，参考价值降低。推荐将追评窗口设置为收货后 7-30 天，具体天数由后台配置。

### 4.2 数据库扩展

**不新建独立追评表，而是在评价主表中增加追评相关字段**。这是最简洁的方案，避免多表关联带来的查询复杂度。

```sql
ALTER TABLE `ls_goods_comment` 
ADD COLUMN `is_reply_again` tinyint(1) DEFAULT '0' COMMENT '是否已追评：0-否；1-是',
ADD COLUMN `reply_again_content` varchar(1000) DEFAULT '' COMMENT '追评内容',
ADD COLUMN `reply_again_image` varchar(2000) DEFAULT '' COMMENT '追评图片（JSON数组）',
ADD COLUMN `reply_again_time` int(11) DEFAULT '0' COMMENT '追评时间';
```

**为什么不新建独立表？** 追评和首次评价是一对一的关系（一条评价只能追评一次），拆表反而增加了 JOIN 查询的成本。用字段扩展的方式，评价列表接口不需要额外的关联查询就能返回追评数据。

### 4.3 追评时间窗口校验

```php
// server/app/shopapi/logic/CommentLogic.php
class CommentLogic
{
    /**
     * 提交追评
     */
    public static function addReplyAgain(array $params, int $userId): bool
    {
        $commentId = $params['comment_id'];

        $comment = CommentModel::where('id', $commentId)
            ->where('user_id', $userId)
            ->where('delete_time', 0)
            ->find();

        if (!$comment) {
            throw new Exception('评价不存在或无权操作');
        }

        // 校验是否已追评
        if ($comment['is_reply_again'] == 1) {
            throw new Exception('该评价已追评，请勿重复操作');
        }

        // 校验追评时间窗口
        $windowDays = ConfigService::get('comment_reply_again_days', 15);
        $orderGoods = OrderGoodsModel::find($comment['order_goods_id']);
        $order = OrderModel::find($orderGoods['order_id']);

        if ($order['finish_time'] + $windowDays * 86400 < time()) {
            throw new Exception("追评时间已过，请在收货后{$windowDays}天内追评");
        }

        // 更新追评字段
        CommentModel::where('id', $commentId)->update([
            'is_reply_again'      => 1,
            'reply_again_content' => $params['content'],
            'reply_again_image'   => json_encode($params['image'] ?? []),
            'reply_again_time'    => time(),
            'update_time'         => time(),
        ]);

        return true;
    }
}
```

### 4.4 追评的前端展示

追评在评价列表中的展示方式建议为**在首次评价下方增加一个“追评”标签区域**，包含追评内容和图片，以及追评时间。

评价列表接口返回的数据中增加以下字段：

```php
// 评价列表返回的追评数据
$item['reply_again'] = [
    'content'   => $comment['reply_again_content'] ?? '',
    'image'     => json_decode($comment['reply_again_image'] ?? '[]', true),
    'time'      => $comment['reply_again_time'] ? date('Y-m-d H:i', $comment['reply_again_time']) : '',
];
```

## 五、商家回复的实现

### 5.1 多商户的回复权限设计

多商户版的评价回复有一个明确的权限边界：**商家可以对会员的商品评价进行回复，但平台拥有评价显示、隐藏和删除权限**。

这个设计的意义在于：**商家可以“解释”评价，但不能“消灭”评价**。商家可以针对差评进行解释和道歉，展示服务态度；但隐藏和删除差评的权限只在平台手里，防止商家操纵评价生态。

平台运营人员可以查看已回复评价和待回复评价，如果某个商家的待回复评价积压较多，平台运营人员应该要求商家积极回复内容。

### 5.2 回复接口的实现

商家回复的写入逻辑相对简单，核心是权限校验和回复内容的写入：

```php
// server/app/adminapi/logic/CommentLogic.php
class CommentLogic
{
    /**
     * 商家回复评价
     */
    public static function reply(array $params, int $shopId): bool
    {
        $commentId = $params['comment_id'];
        $replyContent = trim($params['reply'] ?? '');

        if (empty($replyContent)) {
            throw new Exception('回复内容不能为空');
        }

        // 多商户版必须校验评价归属
        $comment = CommentModel::where('id', $commentId)
            ->where('shop_id', $shopId)
            ->where('delete_time', 0)
            ->find();

        if (!$comment) {
            throw new Exception('评价不存在或无权回复');
        }

        // 校验是否已回复
        if (!empty($comment['reply'])) {
            throw new Exception('该评价已回复，不可重复回复');
        }

        // 写入回复
        CommentModel::where('id', $commentId)->update([
            'reply'       => $replyContent,
            'reply_time'  => time(),
            'update_time' => time(),
        ]);

        return true;
    }
}
```

### 5.3 平台端的评价管理

平台端对评价拥有更高权限，核心操作包括：

**隐藏评价**：平台运营人员点击隐藏按钮，隐藏某条商品评价，隐藏后商城端商品详情处查看不到该条评价。

**删除评价**：平台运营人员点击删除按钮，删除某条商品评价，商城端商品详情处查看不到该条评价。

**批量回复**：平台管理可以勾选评价信息，批量回复或者批量删除评价信息。

平台端隐藏和删除评价的接口实现：

```php
// server/app/adminapi/logic/CommentLogic.php
class CommentLogic
{
    /**
     * 平台隐藏评价
     */
    public static function hide(int $commentId): bool
    {
        // 平台端不做 shop_id 校验，平台可以操作所有评价
        $affected = CommentModel::where('id', $commentId)
            ->where('delete_time', 0)
            ->update([
                'status'      => 3, // 3-已隐藏
                'update_time' => time(),
            ]);

        if (!$affected) {
            throw new Exception('评价不存在或已被删除');
        }

        return true;
    }

    /**
     * 平台删除评价（软删除）
     */
    public static function delete(int $commentId): bool
    {
        $affected = CommentModel::where('id', $commentId)
            ->where('delete_time', 0)
            ->update([
                'delete_time' => time(),
                'update_time' => time(),
            ]);

        if (!$affected) {
            throw new Exception('评价不存在或已被删除');
        }

        return true;
    }
}
```

**注意**：平台端的查询不做 `shop_id` 过滤，因为平台拥有跨商户的全局管理权限。但商家端的查询必须带上 `shop_id`，确保商家只能看到和回复自己店铺的评价。

## 六、二开扩展点与核心约束

### 6.1 新增“差评自动预警”

**需求**：差评产生后自动通知商家，避免错过最佳处理时间窗口。原生评价体系无差评预警机制，差评产生后没有任何自动通知机制，商家需要主动登录后台才能发现。

**改造思路**：在评价提交逻辑中增加差评判断，当 `goods_comment <= 2` 时触发预警通知。

```php
// 在评价提交成功后增加预警逻辑
if ($params['goods_comment'] <= 2) {
    // 异步推送预警通知给商家
    Queue::instance()
        ->do('fire')
        ->job(CommentWarningJob::class)
        ->data([
            'comment_id' => $commentId,
            'shop_id'    => $orderGoods['shop_id'],
            'goods_id'   => $orderGoods['goods_id'],
        ])
        ->push();
}
```

### 6.2 多商户数据隔离

评价体系的多商户数据隔离有两层含义：

**商家端查询必须带 `shop_id`**。商家只能看到和回复自己店铺的评价。

**平台端查询不带 `shop_id`**。平台拥有跨商户的全局管理权限。

二开时新增的任何评价查询接口，都必须明确它属于哪个端，然后决定是否加 `shop_id` 过滤条件。

### 6.3 评价审核与前端展示的联动

评价的审核状态（`status` 字段）控制前端是否展示。二开时如果新增了审核状态值，需要同步更新评价列表接口的查询条件，确保前端只返回审核通过的记录。

## 七、二开避坑清单

**坑一：商家端查询没有加 `shop_id` 过滤。** 这是多商户系统最严重的业务风险。商家A的评价查询接口如果没有加 `shop_id`，会看到商家B的评价数据。

**坑二：追评拆了独立表。** 追评和首次评价是一对一关系，用字段扩展比拆表更简洁。拆表会增加 JOIN 查询的成本，降低评价列表的加载速度。

**坑三：晒图审核粒度太粗。** 原生审核是评价级别的开关，无法处理“文字通过但图片违规”的场景。如果业务有这个需求，需要增加图片级别的审核表。

**坑四：差评没有预警机制。** 差评产生后如果不通知商家，商家可能几天后才看到，错过了最佳处理窗口。建议增加差评自动预警。

**坑五：平台和商家的权限边界模糊。** 商家只有回复权，没有隐藏和删除权。二开时不要把隐藏/删除权限下放给商家。

**坑六：评价列表接口返回了未审核的记录。** 评价列表必须只返回 `status = 1`（审核通过）的记录，未审核的记录不能在前端展示。

## 八、总结

LikeShop 多商户高级版评价体系的核心可以概括为三条线：

**晒单**：图片异步上传后，路径以 JSON 数组存入 `image` 字段。审核状态控制前端展示，如果需要更细粒度的审核，可以扩展图片级别的审核表。

**追评**：不新建独立表，在评价主表中扩展 `is_reply_again`、`reply_again_content` 等字段。追评时间窗口由后台配置，建议设置为收货后 7-30 天。

**商家回复**：商家可以回复评价，但隐藏和删除权限只归平台。商家端查询必须带 `shop_id` 过滤，平台端查询不做商户过滤。

二开时守住三条底线：**商家端查询必须加 shop_id、评价列表只返回审核通过的记录、差评必须触发预警通知**。把这三点处理好，评价体系就能在保障数据隔离的前提下，为平台运营和商家服务提供有效支撑。

在之前的系列文章中，我写了 LikeShop 多商户版的订单状态机、分账对接、商品模块和连锁点餐系统。这一篇聚焦评价体系——电商系统中直接影响转化率、但二开时最容易被低估的模块。

LikeShop 多商户高级版评价体系：晒单、追评与商家回复实现

后端

开发工具

LikeShop多商户版评价体系核心权限设计：商家仅可回复评价，显示/隐藏/删除权限归平台所有，确保评价真实性。系统支持四维评分、晒单图片异步上传、追评时间窗口配置，并通过shop_id严格隔离商户数据。二开需重点处理差评自动预警、图片精细审核及审核状态联动，防止权限越界和未审核评价展示。

对象存储

图片审核

数据存储

代码解释

数据库

服务器

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

LikeShop 多商户高级版评价体系：晒单、追评与商家回复实现-腾讯云开发者社区-腾讯云

LikeShop 多商户高级版评价体系：晒单、追评与商家回复实现

LikeShop 多商户高级版评价体系：晒单、追评与商家回复实现

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐