运行OpenCV人脸识别代码遇Qt插件缺失及人脸框不显示问题

一、Qt平台插件"wayland"缺失错误 #

这个错误确实由cv2.imshow()引发，因为OpenCV的窗口显示依赖Qt库，而你的环境中缺少Wayland对应的Qt插件。可以通过以下几种方式解决：

• 临时切换X11后端：在代码开头添加环境变量设置，强制Qt使用X11而非Wayland：

  import os
  os.environ['QT_QPA_PLATFORM'] = 'xcb'
  import cv2  # 确保cv2在设置环境变量后导入
  

  或者在终端运行脚本时指定环境变量：

  QT_QPA_PLATFORM=xcb python your_script_name.py
  

• 安装缺失的Wayland插件：如果是Debian/Ubuntu类系统，执行以下命令安装对应插件：

  sudo apt update && sudo apt install qtwayland5
  

• 替换显示方式：如果不需要依赖Qt，可以改用matplotlib显示图像，避免该问题：

  import matplotlib.pyplot as plt
  # 绘制方框后
  plt.imshow(cv2.cvtColor(img, cv2.COLOR_BGR2RGB))  # OpenCV是BGR，matplotlib是RGB，需要转换
  plt.show()
  

二、人脸绿色方框不显示问题 #

你的代码中硬编码了人脸坐标(961, 559)，这是导致方框不显示的核心原因——该坐标仅适用于教程中的特定图片，而非你的John.jpeg。正确的做法是使用detectMultiScale返回的检测结果来绘制方框：

1. 替换硬编码的矩形绘制代码，改为遍历检测到的所有人脸：

   # 遍历所有检测到的人脸坐标
   for (x, y, w, h) in face_coordinates:
       # 在原图（而非灰度图）上绘制彩色方框，因为灰度图无法显示彩色
       cv2.rectangle(img, (x, y), (x + w, y + h), (0, 255, 0), 2)
   # 显示带有方框的原图
   cv2.imshow('Face Detection', img)
   

2. 额外检查项：

   • 确认John.jpeg位于脚本的当前工作目录，或者使用绝对路径读取图片
   • 添加图片读取校验，避免因图片未加载导致后续错误：

     img = cv2.imread('John.jpeg')
     if img is None:
         print("Error: 图片未找到，请检查路径")
         exit()
     

修正后的完整代码 #

import os
os.environ['QT_QPA_PLATFORM'] = 'xcb'
import cv2

# 加载人脸检测器
trained_face_data = cv2.CascadeClassifier(cv2.data.haarcascades + "haarcascade_frontalface_default.xml")

# 读取图片并校验
img = cv2.imread('John.jpeg')
if img is None:
    print("Error: 图片未找到，请检查路径")
    exit()

# 转换为灰度图
grayscaled_img = cv2.cvtColor(img, cv2.COLOR_BGR2GRAY)

# 检测人脸
face_coordinates = trained_face_data.detectMultiScale(grayscaled_img)
print("检测到的人脸坐标：", face_coordinates)

# 绘制人脸方框
for (x, y, w, h) in face_coordinates:
    cv2.rectangle(img, (x, y), (x + w, y + h), (0, 255, 0), 2)

# 显示结果
cv2.imshow('Face Detection', img)
cv2.waitKey(0)
cv2.destroyAllWindows()  # 关闭窗口后释放资源
print("Code Completed")

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