Ray并行清洗需确保函数可序列化、分块均衡、配置全局可达、Schema严格统一：显式导入依赖、用绝对路径或ray.put加载配置、强制类型转换、避免浅拷贝与本地路径日志。
Ray任务无法自动序列化自定义清洗函数
Ray默认只支持纯函数或内置类型，遇到含闭包、类方法、未导入模块的函数时会报 CloudPickleError 或 TypeError: cannot serialize 'function' object。清洗逻辑常依赖 pandas、re、外部配置字典，这些容易被忽略。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 把清洗逻辑封装成独立函数，并在函数顶部显式
import pandas as pd、import re等，避免依赖全局作用域 - 不要传入类实例或 lambda 表达式；若需参数，用普通参数传递（如
def clean_chunk(df, drop_cols=None, regex_pattern=r"\s+")） - 用
@ray.remote装饰前，先本地调用测试该函数能否独立运行
分块读取CSV时内存爆满或数据倾斜
直接用 pd.read_csv 读全量再切片会吃光内存；而用 chunksize 后交给 Ray 提交任务，又可能因 chunk 大小不均导致某些 worker 长时间卡住。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用
pd.read_csv(filename, nrows=1)先读 header，再用skiprows+nrows手动分段读取，确保每块行数接近 - 避免用
df.iloc[...].copy()做浅拷贝后送入远程任务——它仍共享底层内存；改用df.copy(deep=True)或直接在远程函数里重读指定行范围 - 对超大文件，优先考虑
dask.dataframe预分区 +map_partitions，再用ray.data.from_dask接入 Ray 生态
Ray集群模式下Worker无法访问本地清洗配置文件
本地跑通的清洗脚本，一上 ray start --head 就报 FileNotFoundError: [Errno 2] No such file or directory: 'config.yaml'，因为 Worker 进程工作目录不是你启动脚本的位置。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 所有配置文件路径必须用绝对路径，且在每个 Worker 上真实存在；推荐用
ray.put(open("config.yaml", "rb").read())把内容序列化进对象存储，再传给远程函数 - 若用
yaml.load，确保pyyaml已在所有节点pip install；Ray 不自动同步 Python 包 - 避免在远程函数里写日志到本地
./log/—— 改用print()或logging.getLogger().info()，输出会被 Ray 捕获并聚合
清洗结果合并时报 ArrowInvalid: Schema at index 1 was different
不同 chunk 清洗后字段类型不一致（比如某块里 user_id 是 int64，另一块是 string），ray.data.concat() 或转 to_pandas() 时直接崩溃。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 清洗函数末尾强制统一 schema：
df["user_id"] = pd.to_numeric(df["user_id"], errors="coerce")，df["timestamp"] = pd.to_datetime(df["timestamp"], errors="coerce") - 不用
pd.concat([df1, df2])合并多个ray.get()结果；改用ray.data.from_pandas_refs([ref1, ref2, ...]).map_batches(...).to_pandas()，让 Ray 在对象存储层做类型对齐 - 对含 nullable 类型（如
Int64,string）的列，提前在清洗函数中调用df.astype({"col": "string"})显式声明
