# DebugAgent Round 1 静态分析报告

> Agent：council/DebugAgent | 日期：2026-04-20
> 代码版本：bbea35d83（feat: 保存时自动填充 template_snapshot）

---

## 分析方法

基于代码静态分析，识别所有访问 `'id'` 键的位置，并按 PHP 8+ 严格类型行为评估触发概率。

---

## 一、所有 "id" 访问位置分析

### 位置 1：AdminGoodsSaveHandle.php 第 77 行（Primary）

```php
return in_array($r['id'], $config['selected_rooms'] ?? []);
```

- **触发条件**：当 `$r`（rooms 数组元素）缺少 `'id'` key
- **PHP 8+ 行为**：直接抛出 `Undefined array key "id"`
- **对比**：SeatSkuService::BatchGenerate 第 100 行有正确写法：`!empty($r['id']) ? $r['id'] : ('room_' . $rIdx)`

### 位置 2：AdminGoodsSaveHandle.php 第 71 行

```php
$template = Db::name('vr_seat_templates')->find($templateId);
$seatMap  = json_decode($template['seat_map'] ?? '{}', true);
```

- **注意**：报错是 `"seat_map"` 不是 `"id"`
- **PHP 8+ 行为**：若 `$template` 是 null，`$template['seat_map']` 抛出 `Undefined array key "seat_map"`
- **二级风险**：若 `$template` 是空数组 `[]`，`$template['seat_map']` 也抛出同样错误

### 位置 3：SeatSkuService::BatchGenerate 第 100 行

```php
$roomId = !empty($room['id']) ? $room['id'] : ('room_' . $rIdx);
```
- **已安全**：有 `!empty()` 防护

### 位置 4：SeatSkuService::ensureAndFillVrSpecTypes 第 283 行

```php
$existingNames = array_column($existingItems, 'name');
```
- **低风险**：若 `$existingItems` 不是数组，`array_column()` 抛出 Warning

---

## 二、表前缀分析

| 方法 | 展开 | 实际表名 |
|------|------|---------|
| `BaseService::table('seat_templates')` | `'vr_' + 'seat_templates'` | `vr_seat_templates` |
| `Db::name('vr_seat_templates')` | ThinkPHP prefix + `vr_seat_templates` | `vrt_vr_seat_templates` |

**关键发现**：BackendArchitect 的 debug 报告已验证 ShopXO 前缀为 `vrt_`，两者等价。

---

## 三、PHP 8+ `??` 操作符关键行为

```php
$template['seat_map'] ?? '{}'
```

PHP 8+ null 合并操作符行为：
- 若 `$template === null` → 返回 `'{}'` ✅
- 若 `$template = []` → 访问 `$template['seat_map']` 时抛出 `Undefined array key "seat_map"` ❌
- 若 `$template['seat_map'] === null` → 返回 `'{}'` ✅

**`??` 不防御"数组存在但键不存在"的情况**。正确的防御写法：
```php
isset($template['seat_map']) ? $template['seat_map'] : '{}'
// 或
($template['seat_map'] ?? null) ?? '{}'  // 先解包键，再解包 null
```

---

## 四、vr_goods_config JSON 解码安全性

```php
$configs = json_decode($rawConfig, true);
if (is_array($configs) && !empty($configs)) {
    foreach ($configs as $i => &$config) {
```

- `$configs` 类型检查正确（`is_array()`）
- `$config['template_id']` 访问安全（在 `foreach` 中不会越界）
- `$config['selected_rooms']` 访问安全（`?? []` 提供默认值）

---

## 五、根因概率评估

| 位置 | 错误类型 | 概率 | 原因 |
|------|---------|------|------|
| 第 77 行 `$r['id']` | "id" | **高** | 如果 room 数据无 id 字段 |
| 第 71 行 `$template['seat_map']` | "seat_map" | **低** | 如果 template 记录不存在 |
| 类型不匹配 | 静默 | **高** | str vs int 类型不一致 |

---

## 六、结论

1. **Primary**：第 77 行 `$r['id']` 无空安全 → 与 BackendArchitect 结论一致
2. **Secondary**：第 71 行 `$template` 可能为 null/[] → 与 BackendArchitect 一致
3. **Table prefix**：两者等价，已排除
4. **PHP 8+ 行为**：`??` 对空数组 `[]` 的键访问无效，需用 `isset()`

---

## 七、Round 2 待验证项

- [ ] 读取 `shopxo/config/database.php` 确认 ShopXO 前缀
- [ ] 读取 `admin/Admin.php` 第 66 行（BackendArchitect 引用的前缀验证代码）
- [ ] 编写 `reports/DebugAgent-ROOT_CAUSE.md`
