Python通过路径变量使用OpenCV读取图像报错的解决方法

按优先级从高到低排查：

路径格式问题 #

• Windows环境下不要混用斜杠，优先选择以下三种合法路径写法，避免转义错误：
  • 单正斜杠：path = "D:/dev/py_scripts/SS1.jpg"
  • 原始字符串+反斜杠：path = r"D:\dev\py_scripts\SS1.jpg"
  • 双反斜杠转义：path = "D:\\dev\\py_scripts\\SS1.jpg"
• 4.5版本以下的OpenCV不支持非ASCII路径，如果路径含中文、全角符号，要么升级OpenCV到4.5+，要么用解码方式读取，绕过imread的路径校验：

import cv2
import numpy as np
# 兼容含中文、特殊字符的路径
image = cv2.imdecode(np.fromfile(path, dtype=np.uint8), cv2.IMREAD_COLOR)

文件有效性校验 #

• 调用imread前先用os模块验证路径真实性，排除文件名拼写错误、后缀不匹配问题：

import os
# 替换为实际传入的path变量
print("路径是否存在：", os.path.exists(path))
print("目标是否为文件：", os.path.isfile(path))

• 手动开启Windows资源管理器的「文件扩展名显示」，确认文件真实后缀和代码中写的一致，避免出现SS1.jpg实际为SS1.jpg.png、SS1.jpg.webp的隐藏后缀问题。
• 手动用系统图片查看器打开目标文件，确认文件未损坏、未被加密、没有被其他进程独占锁定，且当前运行Python的账号有该文件的读取权限。

跨函数传参问题 #

• 打印传入路径的原始表示，排查不可见字符污染：

print(repr(path))

正常输出应为类似'D:/dev/py_scripts/SS1.jpg'的格式，如果输出带多余的引号、换行符、首尾空格（比如'D:/dev/py_scripts/SS1.jpg\n'、'"D:/dev/py_scripts/SS1.jpg"'），先对路径做path = path.strip()处理，再剔除多余的包裹字符。

• 检查路径拼接逻辑，确认跨函数传参时没有多拼/漏拼路径层级、遗漏路径分隔符。

OpenCV环境问题 #

• 执行print(cv2.__version__)确认OpenCV版本可正常读取，若安装包损坏、dll缺失，或同时安装了opencv-python和opencv-python-headless导致包冲突，执行以下命令重装：

pip uninstall -y opencv-python opencv-contrib-python opencv-python-headless
pip install opencv-python

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