Docker环境中使用OpenCV遇UnboundLocalError问题求助

这个错误和opencv-python-headless的导入方式、安装情况无关，是Python变量作用域导致的问题。

核心原因 #

当你在函数内部对cv2进行赋值操作（比如写了cv2 = xxx），Python会自动将cv2视为该函数的局部变量。如果在赋值语句之前调用cv2.imread()，就会触发UnboundLocalError——因为Python认为你在引用一个还未赋值的局部变量。

解决步骤 #

1. 排查代码中的赋值操作
   检查你的脚本，找到所有直接给cv2赋值的代码行，比如误写的cv2 = cv2.VideoCapture(0)、cv2 = some_other_value这类语句，这类操作会改变cv2的变量类型或引用，导致作用域冲突。

2. 修正代码

   • 推荐方案：避免直接给cv2变量赋值，改用其他变量名。比如：

     import cv2
     
     def process_img(inputfile):
         # 用cap代替cv2作为变量名
         cap = cv2.VideoCapture(0)
         image = cv2.imread(inputfile)
         return image
     

   • 若必须修改cv2的全局引用：在函数开头添加global cv2声明，告诉Python使用全局的cv2变量：

     import cv2
     
     def process_img(inputfile):
         global cv2
         cv2 = cv2.VideoCapture(0)
         image = cv2.imread(inputfile)
         return image
     

3. 验证opencv-headless安装正确性
   为彻底排除安装问题，可在Docker容器内执行以下命令，确认包已正确安装：

   python -c "import cv2; print(cv2.__version__)"
   

   若输出4.8.1.78，说明安装无问题，错误确实来自代码作用域。

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