# 分面数据问题完整分析报告

## 问题现象

前端显示的分面结果都是空的：
- Category: 空
- Color: 空
- Size: 空
- Material: 空

ES的聚合查询结果也是空的。

## 诊断结果分析

### MySQL数据检查结果

1. **category_path字段**：
   - 总SPU数：11254
   - 有category_path的SPU：只有1个
   - 该值：`593389466647815326,593389582007954165,593389582008019701`（ID列表格式，逗号分隔）

2. **option表数据**：
   - 总option记录数：2658
   - 有option定义的SPU数量：886个
   - **position=1, name='color'**: 885个SPU ✅
   - **position=2, name='size'**: 885个SPU ✅
   - **position=3, name='material'**: 885个SPU ✅

3. **SKU数据**：
   - 总SKU数：43109
   - 应该有option1/2/3值

### ES数据检查结果

1. **category1_name字段**：
   - 总文档数：10000
   - 有category1_name的文档：只有1个
   - 该值：`593389466647815326,593389582007954165,593389582008019701`（ID列表格式）

2. **specifications字段**：
   - ES聚合查询显示**有数据**：
     - specifications.color: Beige: 1226, Khaki: 1176, Red: 1168等
     - specifications.size: 1: 1234, 12: 1234等
     - specifications.material: 塑料英文包装: 17277等

## 问题根源

### 问题1：category1_name 几乎都为空 ✅ 已找到原因

**原因**：
1. MySQL的`category_path`字段几乎都是空的（只有1个，而且是ID列表格式）
2. 当`category_path`为空时，代码会使用`category`字段作为备选（代码已修复）
3. 但需要检查MySQL的`category`字段是否有值

**数据流转**：
- Excel "专辑名称" → 店匠系统 → MySQL `category` 或 `category_path` 字段
- 如果Excel导入时"专辑名称"没有正确映射，或者`category`字段也为空，就会导致`category1_name`为空

### 问题2：为什么specifications分面查询无结果

**ES聚合查询显示有数据**，但前端显示为空，可能原因：

1. **前端搜索时有查询条件**：
   - 如果有查询条件（如`query="手机"`），ES会先过滤文档
   - 过滤后的文档如果没有specifications数据，聚合结果就会为空
   - 但这不应该导致所有分面都为空

2. **分面聚合构建问题**：
   - 前端请求：`["category1_name", "specifications.color", "specifications.size", "specifications.material"]`
   - ES构建的聚合名称：`category1_name_facet`, `specifications_color_facet`等
   - 可能聚合构建或解析有问题

3. **tenant_id过滤问题**：
   - 如果搜索时tenant_id不匹配，可能导致没有匹配的文档

## 需要检查的关键点

### 1. MySQL的category字段是否有值

**需要运行SQL查询**：
```sql
SELECT 
    COUNT(*) as total,
    COUNT(category) as has_category,
    COUNT(*) - COUNT(category) as null_category
FROM shoplazza_product_spu
WHERE tenant_id = 162 AND deleted = 0;
```

**如果category字段也为空**：
- 说明Excel导入时"专辑名称"字段没有正确映射到MySQL的`category`字段
- 需要检查店匠系统的字段映射配置

### 2. SKU的option1/2/3字段是否有值

**需要运行SQL查询**：
```sql
SELECT 
    COUNT(*) as total_skus,
    COUNT(option1) as has_option1,
    COUNT(option2) as has_option2,
    COUNT(option3) as has_option3
FROM shoplazza_product_sku
WHERE tenant_id = 162 AND deleted = 0;
```

### 3. 检查ES聚合查询

**运行检查脚本**：
```bash
python scripts/check_es_data.py --tenant-id 162
```

查看：
- 是否有category1_name数据
- specifications聚合是否有数据

## 解决方案

### 方案1：修复category1_name字段生成（代码已修复）

**已修复的代码**（`indexer/spu_transformer.py`第241-259行）：
- 如果`category_path`为空，使用`category`字段作为备选
- 从`category`字段解析多级分类

**但需要确保**：
1. MySQL的`category`字段有值
2. 重新导入数据到ES

### 方案2：检查并修复MySQL数据

如果MySQL的`category`字段也为空：

1. **检查Excel导入映射**：
   - 确认"专辑名称"字段是否正确映射到MySQL的`category`字段
   - 如果不正确，需要修复映射或重新导入

2. **如果category字段有值但category1_name仍为空**：
   - 说明数据导入时使用的是旧代码
   - 需要重新导入数据到ES

### 方案3：验证specifications分面查询

虽然ES聚合查询显示有数据，但需要验证：

1. **检查前端搜索请求**：
   - 确认分面请求是否正确发送
   - 确认tenant_id是否正确

2. **检查ES聚合结果解析**：
   - 确认`format_facets`函数是否正确解析specifications分面
   - 确认字段名匹配是否正确（`specifications.color` vs `specifications_color_facet`）

## 立即执行的操作

### 步骤1：检查MySQL的category字段

更新诊断脚本，添加category字段检查：
```bash
# 需要手动运行SQL或更新诊断脚本
```

### 步骤2：重新导入数据到ES

修复代码后，重新导入数据：
```bash
python scripts/recreate_and_import.py \
    --tenant-id 162 \
    --db-host <host> \
    --db-database saas \
    --db-username saas \
    --db-password <password> \
    --es-host http://localhost:9200
```

### 步骤3：验证ES数据

运行ES数据检查脚本：
```bash
python scripts/check_es_data.py --tenant-id 162
```

## 关键发现

1. **specifications数据是存在的**：ES聚合查询能正常返回color/size/material的分面数据
2. **category1_name几乎都是空的**：这是因为`category_path`为空，需要从`category`字段生成
3. **需要重新导入数据**：修复代码后，需要重新导入数据到ES才能生效