DuckDB转换错误：无法将'CHINA'转为UNIT8的问题求助

API 探路者

2026-7-26

排查方向

确认COUNTRY列的实际数据类型
报错提示无法将字符串转成UINT8，大概率该列不是普通字符串类型，而是枚举（ENUM）类型（DuckDB的枚举底层用整数存储，比如UINT8）。可以执行以下SQL或Python代码验证：
```
DESCRIBE tbl;
```
或者在Python中：
```
col_type = self._con.execute("SELECT typeof(COUNTRY) FROM tbl LIMIT 1").fetchone()[0]
print(col_type)
```
如果是枚举类型，继续看后续排查点。
验证枚举类型的IN子句处理逻辑（针对DuckDB 0.7.1）
DuckDB 0.7.1属于较旧版本，存在枚举类型相关的已知bug：当IN子句中包含枚举定义里不存在的字符串值时，查询优化阶段会尝试将所有IN值转换为枚举对应的整数类型，哪怕表中没有该值，直接触发转换错误，而非返回空结果。这就是为什么移除'CHINA'后查询正常——剩下的字符串在枚举定义中存在。
尝试显式类型转换规避错误
修改SQL语句，将IN子句中的每个值显式转换为COUNTRY列的类型，看是否能绕过转换错误：
```
FROM 
    tbl 
WHERE 
    tbl.COUNTRY IN (
        CAST('BRAZIL' AS typeof(tbl.COUNTRY)),
        CAST('INDIA' AS typeof(tbl.COUNTRY)),
        CAST('CHINA' AS typeof(tbl.COUNTRY))
    )
```
这种方式可能让DuckDB正确处理不存在的枚举值，返回空结果而非抛出异常。
升级DuckDB版本测试
DuckDB后续版本（如0.8.x及以上）修复了多个枚举类型的处理bug。尝试升级DuckDB到最新稳定版，重新执行查询，看问题是否消失：
```
pip install --upgrade duckdb
```
检查完整查询的隐式转换逻辑
确认SQL语句的其他部分（如SELECT子句、JOIN条件、子查询等）是否对COUNTRY列做了隐式类型转换，导致查询优化器提前触发字符串到UINT8的转换操作，进而引发异常。