starRiverProperty/docs/superpowers/data/2026-05-05-componentorg-service-errors-classification.md

Component-Org Service 编译错误分类 (200 errors, 8 files)

日期: 2026-05-05
构建: mvn compile -DskipTests -s ../maven-cw-elevator-application/.mvn/settings.xml
JDK: 1.8.0_482 | Spring Boot: 1.5.22 | CFR 反编译: 0.152

---

错误总览

类别	数量	根因	自动修复难度
No-symbol (找不到符号)	78	$$$ ast-grep 残留 + raw stream 调用 + 方法歧义	⭐⭐ 中
Object→cast	76	raw List/Map 失去泛型	⭐⭐⭐ 高
Type-mismatch	22	类型声明与使用不匹配	⭐⭐ 中
Ambiguous (方法歧义)	16	redisTemplate.execute() 歧义	⭐ 低
Type-inf (类型推断)	6	空集合初始化泛型推断	⭐ 低

总计: 200 errors in 8 files

---

1. No-symbol (78 errors)

1.1 $$$ ast-grep 残留 (36 errors)

涉及文件: CpOrgDevieKitServiceImpl (32), OrganizationUnitTypeServiceImpl (12), AreaTypeServiceImpl (2)

根因: ast_grep_replace 将 return CloudwalkResult.success(X) 改为 return (CloudwalkResult) CloudwalkResult.success($$$) 时, $$$ 捕获参数但 rewrite 时 $$$ 在 success() 括号内丢失了 X — X 变量覆盖了 $$$ 变量名。

源代码模式:

// 改写前 (ast-grep)
return CloudwalkResult.success(updateGroupResult);
// 改写后 (异常)
return (CloudwalkResult) CloudwalkResult.success($$$);

修复方案: 逐行恢复原始表达式。

影响方法:

• CpOrgDevieKitServiceImpl: onUpdateGroupRequest(L117), onUpdateFeatureRequest(L127/L140/L166), onUpdatePictureRequest(L176/L189/L215), onUpdatePersonRequest(L235/L255/L310), handlePersonValidDate(L522/L530)
• OrganizationUnitTypeServiceImpl: page(L76), getList(L110), defaultInitOrgType(L121/L145), initParkOrg(L188/L227)
• AreaTypeServiceImpl: add(L104)

1.2 raw stream .map() 调用 Object 方法 (12 errors)

涉及文件: OrganizationServiceImpl.detail(L814,L815,L824,L843), CpImageStorePersonManager(L110,L357,L365,L386)

根因: raw List 的 .stream() 返回 Stream<Object>, 对 Object 调用 .getAreaId() / .getImageStoreId() 找不到方法。

源代码模式:

// refDTOS 是 raw List, stream() 是 Stream<Object>
List officeArea = refDTOS.stream()
    .filter(it -> it.getRefType() == 0)  // Object 没有 getRefType()
    .map(o -> o.getAreaId())              // Object 没有 getAreaId()
    .collect(Collectors.toList());

修复方案: 在 stream 前添加 (List<OrganizationAreaRefDTO>) 转换，或定义变量时指定泛型。

1.3 redisTemplate.delete(Object) (2 errors)

涉及文件: CpOrgDevieKitServiceImpl.unlockSyncLog(L593)

根因: redisTemplate.delete(Object) — RedisTemplate 的 delete() 签名是 delete(K key) 泛型, 传入 Object 无法匹配。

修复方案: 删除 (Object) 转型, 直接传 key: this.redisTemplate.delete(key);

---

2. Object→cast (76 errors)

2.1 for-each over raw Collection (30+ errors)

涉及文件: CpImageStorePersonSynManager, CpImageStorePersonValidateManager, CpOrgDevieKitServiceImpl

根因: raw List/Map 遍历时 Iterator 返回 Object, 无法赋值给具体类型。

源代码模式:

// removeMap 是 raw Map
for (Map.Entry entry : removeMap.entrySet()) { ... }
// 修复:
for (Map.Entry<Long, Set<SyncPersonLocal>> entry : removeMap.entrySet()) { ... }

// personInfoDataDatas 是 raw Collection
for (DeviceImageUpdateFeautreResult deviceUpdatePersonResult : personInfoDataDatas) { ... }
// 修复: 声明 personInfoDataDatas 为 Collection<DeviceImageUpdateFeautreResult>

修复方案: 找到 raw Collection 的声明位置, 添加泛型类型参数。如果变量有多态使用, 则添加 (Collection<Type>) 转换。

2.2 redisTemplate.keys() 返回 raw Set (8 errors)

涉及文件: CpImageStorePersonSynManager.checkHandleSynTaskException(L489,L492,L499,L502)

根因: redisTemplate.keys(pattern) 返回 Set<K>, 但声明为 raw Set, 后续 .replaceFirst() 等方法在 Object 上找不到。

源代码模式:

Set synQueueHeadDataKeys = this.redisTemplate.keys(...);
String imageStoreId = synQueueHeadDataKey.replaceFirst(SYN_QUEUE_HEAD_DATA, "");

修复方案: 声明为 Set<String>:

Set<String> synQueueHeadDataKeys = this.redisTemplate.keys(...);

2.3 Map.get() 返回 Object (8 errors)

涉及文件: CpImageStorePersonManager(L316,L336), OrganizationUnitTypeServiceImpl(L59)

根因: raw Map 的 get() 返回 Object, 无法调用 .setPersonId() 或赋值给 Integer。

修复方案: 声明 Map 为 Map<K, V> 泛型, 或在 get() 结果上添加强制转型。

2.4 stream().collect() 返回 Object (10 errors)

涉及文件: OrganizationServiceImpl.saveAreaDetails(L963,L970,L974,L981)

根因: raw List 的 stream 操作, collect 返回 Object 无法赋值给具体类型。

修复方案: 在 stream 前添加 (List<String>) 转换:

List passableList = ((List<String>)passableArea).stream().map(...).collect(Collectors.toList());

---

3. Type-mismatch (22 errors)

3.1 String → Set<String> 转型 (8 errors)

涉及文件: CpImageStorePersonSynManager(L489,L492,L499,L502)

根因: 代码写了 (java.lang.String) 转型但实际类型是 Set:

Set synQueueHeadDataKeys = (java.lang.String) this.redisTemplate.keys(...);

修复方案: 修改转型为目标类型:

Set<String> synQueueHeadDataKeys = this.redisTemplate.keys(...);

3.2 三元表达式类型不一致 (4 errors)

涉及文件: CpImageStorePersonValidateManager(L150, L453)

根因:

List<Object> syncPersonDtoList = StringUtils.isNotBlank(dataSet) 
    ? JsonUtils.toObjList(dataSet, SyncPersonLocal.class) 
    : new ArrayList<>();  // inferred as ArrayList<Object>

JsonUtils.toObjList() 返回 List<SyncPersonLocal>, new ArrayList<>() 推断为 ArrayList<Object>, 三元运算符的两个分支类型不一致。

修复方案: 指定 ArrayList 的泛型:

: new ArrayList<SyncPersonLocal>()

3.3 ArrayList<String> vs List<String> (2 errors)

涉及文件: OrganizationServiceImpl.getList(L552)

根因: ids 声明为 ArrayList<String> 但 param.getIds() 返回 List<String>, 不能直接赋值。

修复方案:

ids = new ArrayList<>(param.getIds());  // 或
ids.clear(); ids.addAll(param.getIds());

3.4 List<Object> vs List<String> (2 errors)

涉及文件: OrganizationServiceImpl.detail(L826)

根因: zoneIds 声明为 List<Object> 但 result.setZoneIds() 接受 List<String>。

修复方案:

result.setZoneIds((List<String>)(List<?>) zoneIds);  // 双重转型绕过泛型检查

3.5 List<List<T>> vs List<List> (2 errors)

涉及文件: CpImageStorePersonTxHandler.handleImageStorePersonDelete(L201)

根因: Lists.partition() 返回 List<List<T>> 但赋值给 List<List>。

修复方案:

List<List<String>> partition = Lists.partition(changePersonIds, delBatchSize);

---

4. Ambiguous (16 errors) - redisTemplate.execute() 歧义

涉及文件: CpImageStorePersonSynManager (12), CpImageStorePersonValidateManager (4)

根因: RedisTemplate<K,V>.execute() 有两个重载:

• execute(RedisCallback<T> callback)
• execute(SessionCallback<T> callback)

lambda connection -> connection.eval(...) 同时匹配 RedisCallback 和 SessionCallback。

源代码:

this.redisTemplate.execute(connection -> (Long)connection.eval(lua, keys, args))

修复方案: 添加 lambda 参数类型或转型:

this.redisTemplate.execute((RedisCallback<Long>) connection -> connection.eval(lua, keys, args))

---

5. Type-inf (6 errors) - 类型推断失败

5.1 Sets.newHashSet() 泛型推断 (2 errors)

涉及文件: CpImageStorePersonTxHandler.deletePersonFromImageStores(L221)

根因: Sets.newHashSet((Object[])new String[]{imageId}) — 重建数组丢失类型。

修复方案:

Sets.newHashSet(imageId)  // 或
Sets.<String>newHashSet(new String[]{imageId})

5.2 Map infer from stream (4 errors)

涉及文件: CpImageStorePersonSynManager.handleImageStoreIncrementSyn(L417,L418)

根因: .collect(Collectors.groupingBy(...)) 的结果赋值给 Map<String, List<GroupPersonRef>> 但 stream 是 raw。

修复方案: 先转型 source 再 stream。

---

每文件修复优先级

文件	错误数	主要类别	修复复杂度	预估时间
CpOrgDevieKitServiceImpl	54	$$ (32), Obj→cast (20)	⭐⭐	30 min
CpImageStorePersonSynManager	38	Obj→cast (10), Ambiguous (12)	⭐⭐	25 min
OrganizationServiceImpl	32	No-sym (14), Obj→cast (14)	⭐⭐	20 min
CpImageStorePersonValidateManager	28	Obj→cast (12), Type-mis (8)	⭐⭐	20 min
CpImageStorePersonManager	16	No-sym (8), Obj→cast (8)	⭐⭐	15 min
OrganizationUnitTypeServiceImpl	14	$$ (12), Obj→cast (2)	⭐	10 min
AreaTypeServiceImpl	10	$$ (2), Obj→cast (8)	⭐	10 min
CpImageStorePersonTxHandler	8	Type-mis (2), No-sym (2)	⭐	5 min

总预估: 约 2 小时逐行修复。