# 问题修复 - 错误码2300070未加入俱乐部提示 v3.11.24

**版本**: v3.11.24  
**日期**: 2025-10-08  
**类型**: 问题修复 / 用户体验改进

## 问题描述

用户反馈在批量任务执行时，遇到以下错误：

```
俱乐部签到失败
服务器错误: 2300070 - 未知错误

发车失败
服务器错误: 2300070 - 未知错误
```

**实际情况**：该账号未加入俱乐部

**问题分析**：
- 俱乐部签到和发车功能都需要账号先加入俱乐部
- 服务器返回错误码 `2300070` 表示未加入俱乐部
- 但系统显示为"未知错误"，用户无法了解真实原因
- 需要识别这个错误码并给出友好提示

## 错误码说明

### 2300070 错误码

**含义**: 账号未加入俱乐部

**影响范围**：
- ❌ 俱乐部签到 - 需要加入俱乐部
- ❌ 发车功能 - 需要加入俱乐部才能使用赛车
- ✅ 其他功能（每日修复、自动学习、领取奖励等）不受影响

**处理策略**：
- 识别错误码 2300070
- 显示友好的错误提示："该账号未加入俱乐部"
- 标记为失败（因为无法完成操作）
- 停止继续尝试（避免重复失败）

## 解决方案

### 1. 俱乐部签到错误处理

在 `legionSignIn` 任务中添加对错误码 2300070 的识别：

```javascript
case 'legionSignIn':
  // 俱乐部签到
  return await executeSubTask(
    tokenId,
    'legion_signin',
    '俱乐部签到',
    async () => {
      try {
        const result = await client.sendWithPromise('legion_signin', {}, 5000)
        return result
      } catch (error) {
        const errorMsg = error.message || String(error)
        
        // 错误码 2300190 表示"今日已签到"，不应视为错误
        if (errorMsg.includes('2300190')) {
          console.log('ℹ️ 俱乐部今日已签到，跳过')
          return { alreadySignedIn: true }
        }
        
        // ✅ 新增：错误码 2300070 表示"未加入俱乐部"
        if (errorMsg.includes('2300070')) {
          console.log('⚠️ 俱乐部签到失败：该账号未加入俱乐部')
          throw new Error('该账号未加入俱乐部，无法签到')
        }
        
        // 超时错误：提示用户检查游戏内实际状态
        if (errorMsg.includes('请求超时') || errorMsg.includes('timeout')) {
          console.warn('⚠️ 俱乐部签到超时，请检查游戏内是否已签到')
          return { timeout: true, message: '超时（可能已成功，请检查游戏内状态）' }
        }
        
        // 其他错误正常抛出
        throw error
      }
    },
    false
  )
```

### 2. 发车功能 - 查询车辆错误处理

在 `queryClubCars` 函数中添加对错误码 2300070 的识别：

```javascript
const queryClubCars = async () => {
  console.log(`🚗 [${tokenId}] 开始查询俱乐部车辆...`)
  try {
    const response = await tokenStore.sendMessageAsync(tokenId, 'car_getrolecar', {}, 5000)
    
    if (!response || !response.roleCar) {
      throw new Error('查询车辆失败：未返回车辆数据')
    }
    
    const carDataMap = response.roleCar.carDataMap || {}
    const carIds = Object.keys(carDataMap).sort()
    
    return { carDataMap, carIds }
  } catch (error) {
    const errorMsg = error.message || String(error)
    // ✅ 新增：检查是否是未加入俱乐部的错误（200400 或 2300070）
    if (errorMsg.includes('200400') || errorMsg.includes('2300070')) {
      throw new Error('该账号未加入俱乐部或没有赛车权限')
    }
    throw error
  }
}
```

### 3. 发车功能 - 发送车辆错误处理

在发送车辆的错误处理中添加对错误码 2300070 的识别：

```javascript
} catch (error) {
  const errorMsg = error.message || String(error)
  
  // 区分不同的错误类型
  if (errorMsg.includes('12000050')) {
    console.log(`⚠️ [${tokenId}] 车辆 ${carId} 发送失败: 今日发车次数已达上限（服务器端限制）`)
    localStorage.setItem(dailySendKey, '4')
    dailySendCount = 4
    break
  } else if (errorMsg.includes('200020')) {
    console.log(`⚠️ [${tokenId}] 车辆 ${carId} 处于发送冷却期`)
  } else if (errorMsg.includes('200350')) {
    console.log(`⚠️ [${tokenId}] 车辆 ${carId} 发送失败: 非发车时间（6:00-20:00）或已发车后收车`)
    sendSkipCount++
    break
  } else if (errorMsg.includes('2300070')) {
    // ✅ 新增：错误码2300070：未加入俱乐部
    console.log(`⚠️ [${tokenId}] 发车失败: 该账号未加入俱乐部`)
    sendSkipCount++
    break
  } else {
    console.error(`❌ [${tokenId}] 发送车辆失败: ${carId} - ${errorMsg}`)
  }
}
```

## 修改文件

### src/stores/batchTaskStore.js

**修改位置**：
1. **line 1050-1053**: `legionSignIn` 任务 - 添加 2300070 错误识别
2. **line 1258**: `queryClubCars` 函数 - 添加 2300070 错误识别
3. **line 1560-1566**: 发送车辆错误处理 - 添加 2300070 错误识别

## 用户体验改进

### 修改前

```
执行进度详情
┌─────────────────────────────┐
│ ❌ 俱乐部签到               │
│    服务器错误: 2300070 -    │
│    未知错误                 │
├─────────────────────────────┤
│ ❌ 发车                     │
│    服务器错误: 2300070 -    │
│    未知错误                 │
└─────────────────────────────┘

问题：
- ❌ "未知错误" 没有提供有用信息
- ❌ 用户不知道是什么原因
- ❌ 用户不知道如何解决
```

### 修改后

```
执行进度详情
┌─────────────────────────────┐
│ ❌ 俱乐部签到               │
│    该账号未加入俱乐部，     │
│    无法签到                 │
├─────────────────────────────┤
│ ❌ 发车                     │
│    该账号未加入俱乐部或     │
│    没有赛车权限             │
└─────────────────────────────┘

改进：
- ✅ 明确说明失败原因
- ✅ 用户知道是未加入俱乐部导致
- ✅ 用户知道需要先加入俱乐部
```

### 控制台日志

**修改前**：
```
❌ [10684...] 俱乐部签到失败: 服务器错误: 2300070 - 未知错误
❌ [10684...] 发送车辆失败: 1 - 服务器错误: 2300070 - 未知错误
```

**修改后**：
```
⚠️ 俱乐部签到失败：该账号未加入俱乐部
⚠️ [10684...] 发车失败: 该账号未加入俱乐部
```

## 相关错误码对比

### 俱乐部相关错误码

| 错误码 | 含义 | 处理方式 |
|--------|------|---------|
| `2300070` | 未加入俱乐部 | ❌ 失败，提示加入俱乐部 |
| `2300190` | 今日已签到 | ✅ 跳过，视为成功 |
| `200400` | 未加入俱乐部或无权限 | ❌ 失败，提示加入俱乐部 |

### 发车相关错误码

| 错误码 | 含义 | 处理方式 |
|--------|------|---------|
| `2300070` | 未加入俱乐部 | ⚠️ 跳过，停止继续尝试 |
| `200350` | 非发车时间或已收车 | ⚠️ 跳过，停止继续尝试 |
| `200020` | 发送冷却期 | ⚠️ 跳过，继续下一辆 |
| `12000050` | 今日发车已达上限 | ⚠️ 跳过，停止继续尝试 |
| `200400` | 未加入俱乐部或无权限 | ❌ 失败，停止执行 |

## 处理策略差异

### 俱乐部签到

```javascript
if (errorMsg.includes('2300070')) {
  // 抛出错误，标记任务为失败
  throw new Error('该账号未加入俱乐部，无法签到')
}
```

**原因**：
- 签到是单一操作
- 失败就是失败，没有备选方案
- 需要让用户知道明确的失败状态

### 发车功能

```javascript
} else if (errorMsg.includes('2300070')) {
  // 不抛出错误，计入 sendSkipCount
  console.log(`⚠️ [${tokenId}] 发车失败: 该账号未加入俱乐部`)
  sendSkipCount++
  break
}
```

**原因**：
- 发车是批量操作（可能尝试多辆车）
- 未加入俱乐部意味着所有车辆都无法发送
- 使用 `break` 立即停止，避免重复失败
- 计入 `sendSkipCount` 而非失败计数
- 最终任务仍会失败（因为 `sendSuccessCount === 0`）

## 技术要点

### 错误识别优先级

在错误处理中，按照以下优先级检查：

1. **特殊成功状态**（如 2300190 已签到）→ 返回成功
2. **可识别的错误码**（如 2300070 未加入）→ 友好提示
3. **超时错误** → 特殊处理（可能已成功）
4. **其他错误** → 原样抛出

```javascript
if (errorMsg.includes('2300190')) {
  return { alreadySignedIn: true }  // 1. 特殊成功
}
if (errorMsg.includes('2300070')) {
  throw new Error('友好提示')  // 2. 可识别错误
}
if (errorMsg.includes('timeout')) {
  return { timeout: true }  // 3. 超时
}
throw error  // 4. 其他错误
```

### 错误消息转换

```javascript
// 系统错误（不友好）
服务器错误: 2300070 - 未知错误

// 转换后（友好）
该账号未加入俱乐部，无法签到
```

**转换方法**：
```javascript
if (errorMsg.includes('2300070')) {
  throw new Error('该账号未加入俱乐部，无法签到')
}
```

## 测试验证

### 测试场景

1. ✅ **未加入俱乐部**
   - 俱乐部签到 → 显示"该账号未加入俱乐部，无法签到"
   - 发车 → 显示"该账号未加入俱乐部或没有赛车权限"

2. ✅ **已加入俱乐部**
   - 俱乐部签到 → 正常签到或显示"今日已签到"
   - 发车 → 正常发车或其他错误提示

3. ✅ **其他错误**
   - 超时 → "超时（可能已成功，请检查游戏内状态）"
   - 未知错误 → 显示原始错误信息

### 预期行为

**未加入俱乐部的账号**：
```
总任务: 7
成功: 5（每日修复、自动学习、领取奖励、加钟、爬塔）
失败: 2（俱乐部签到、发车）

失败任务详情：
- ❌ 俱乐部签到: 该账号未加入俱乐部，无法签到
- ❌ 发车: 该账号未加入俱乐部或没有赛车权限
```

## 用户指南

### 如何解决此问题？

当看到"该账号未加入俱乐部"提示时：

1. **进入游戏**
2. **加入俱乐部**：
   - 点击游戏内的"俱乐部"功能
   - 搜索并申请加入一个俱乐部
   - 或创建自己的俱乐部
3. **等待审核通过**（如果是申请加入）
4. **重新执行任务**

**注意**：
- 俱乐部签到和发车功能必须先加入俱乐部
- 其他任务（每日修复、学习、领奖等）不受影响
- 如果不需要这两个功能，可以使用"快速套餐"模板

## 相关版本

- **v3.11.1**: 修复俱乐部签到错误码 2300190
- **v3.11.15**: 修复俱乐部签到超时误判
- **v3.11.20**: 修复发车错误码 200350
- **v3.11.24**: 添加错误码 2300070 识别（本版本）

## 总结

**核心改进**：
- 🔍 识别错误码 2300070（未加入俱乐部）
- 💬 提供友好的错误提示
- 📊 在三个位置添加错误处理（俱乐部签到、查询车辆、发送车辆）
- ✅ 帮助用户快速定位问题原因

**用户获益**：
- ✅ 明确知道失败原因
- ✅ 知道如何解决问题
- ✅ 减少疑惑和困扰
- ✅ 提升整体体验

---

**状态**: ✅ 已完成  
**版本**: v3.11.24

