OpenCV转YCrCb触发_src.empty断言失败，图像数据集预处理流程报错

该报错的触发逻辑非常直接：cv2.cvtColor执行前会校验传入的源图像矩阵是否为空，当接收到None值时就会抛出(-215:Assertion failed) !_src.empty()的断言错误。
报错的抛错点在cvtColor行，但根因在上一行的cv2.imread()——当图像读取失败时，OpenCV不会主动抛出可读的异常，只会返回None值，这个空值直接传给下一行的色彩转换函数，就触发了当前的崩溃。

• 路径拼接错误：原代码用字符串硬拼路径name = _path + names[i]，如果DATA_PATH定义时没有在末尾加路径分隔符（Windows下的\、Linux/macOS下的/），拼出来的文件路径会完全失效。比如DATA_PATH = "C:/dataset/train"，拼出来的路径会变成C:/dataset/trainimg_001.png，指向根本不存在的位置，OpenCV找不到文件就会返回空值。
• 目录混入非图像文件：os.listdir()会遍历路径下的所有文件项，包括系统自动生成的Thumbs.db、隐藏缓存文件、临时上传残留的碎片文件，这类没有合法图像编码的文件，会直接导致OpenCV解码失败返回空值，循环到对应位置就会崩溃。
• OpenCV原生imread的兼容缺陷：Windows环境下，如果数据集路径、文件名包含中文/全角特殊字符，原生cv2.imread()会直接读取失败返回None，这是OpenCV长期存在的兼容问题，哪怕路径完全正确也会触发。之前换其他IO库测试时，大概率是刚好没走到这类带特殊字符文件的读入分支，没有解决核心问题。
• 图像文件本身损坏：数据集下载不完整、文件传输中断导致的图像文件头损坏，哪怕后缀是标准的.jpg/.png，OpenCV也无法完成解码，返回空值。

1. 替换原代码的硬拼路径逻辑，删掉手动字符串拼接，换成跨平台兼容的路径拼接方法，从根源避免路径错误。
2. 替换原生cv2.imread()的调用方式，绕开中文路径兼容问题，同时加上读入判空逻辑，把无效文件拦截在色彩转换之前，避免直接崩溃。
   替换后的循环核心代码如下：

for i in range(nums):
    # 替换手动拼接的路径逻辑
    name = os.path.join(_path, names[i])
    # 跳过路径下的子目录项
    if not os.path.isfile(name):
        continue
    # 用字节流解码方式读入图像，兼容中文路径
    try:
        img_buf = numpy.fromfile(name, dtype=numpy.uint8)
        hr_img = cv2.imdecode(img_buf, cv2.IMREAD_COLOR)
    except Exception as e:
        print(f"跳过损坏文件：{name}，错误信息：{e}")
        continue
    # 判空：如果图像解码失败直接跳过，不进入后续流程
    if hr_img is None:
        print(f"无法解码图像，跳过：{name}")
        continue
    # 到这里后续的cvtColor逻辑就不会触发空断言错误了
    hr_img = cv2.cvtColor(hr_img, cv2.COLOR_BGR2YCrCb)
    hr_img = hr_img[:, :, 0]

3. 补全潜在的版本兼容坑：原代码里cv2.resize()传入的尺寸参数是除法计算的浮点数，在Python3环境下OpenCV不接受浮点数作为尺寸参数，后续跑通流程后会触发参数类型错误，需要把对应位置的除法结果强制转成整数：

# 原代码的resize参数会是浮点数，修改为
lr_img = cv2.resize(hr_img, (int(shape[1] / scale), int(shape[0] / scale)))
lr_img = cv2.resize(lr_img, (shape[1], shape[0]))
# 切片数计算的结果也要转成整数，否则range()传浮点数会直接报错
width_num = int((shape[0] - (BLOCK_SIZE - BLOCK_STEP) * 2) / BLOCK_STEP)
height_num = int((shape[1] - (BLOCK_SIZE - BLOCK_STEP) * 2) / BLOCK_STEP)

第一次运行修复后的代码时，终端会打印出所有读取失败的文件路径，顺着打印的路径就能直接定位是路径拼错、文件损坏还是存在中文路径的问题，不需要逐行翻文件排查。

内容的提问来源于stack exchange，提问作者WhynarySearch