使用OpenCV检测ArUco marker时返回ids为None、corners为空的问题

核心原因及对应解决方法 #

• 字典类型不匹配（最高发问题）
  你代码中使用的是aruco.DICT_5X5_250字典，若生成ID为10的标记时选择的字典规格和代码中不一致（比如选了4X4系列、6X6系列，或者同是5X5但总ID容量不是250，比如DICT_5X5_100），就会完全检测不到结果。
  排查方式：确认生成标记时的字典参数，和代码中调用的字典完全一致，同时确认ID10属于对应字典的ID范围。

• 图像读取失败
  如果代码工作目录下没有temp.jpg文件、路径拼写错误、文件损坏，cv2.imread会返回空值，后续检测自然无结果。
  排查方式：在图像读取后加校验逻辑：

img = cv2.imread("temp.jpg")
if img is None:
    print("图像读取失败，请检查文件路径")
    exit()

也可以打印img.shape确认图像维度正常。

• 标记本身不符合检测要求
  ArUco标记对格式有明确要求，以下情况会导致检测失败：
  1. 标记四周没有预留至少2个bit宽度的白色边框，默认生成的标记会自带边框，手动裁剪过标记就会出问题
  2. 标记模糊、反光、拍摄角度倾斜过大、尺寸过小
     排查方式：用代码直接生成同规格的标记，保存到本地后再用检测代码读取测试，排除标记本身的问题：

# 生成同字典同ID的标记代码
aruco_dict = aruco.Dictionary_get(aruco.DICT_5X5_250)
marker_img = aruco.drawMarker(aruco_dict, 10, 200) # 200是像素尺寸
cv2.imwrite("test_marker.jpg", marker_img)

用生成的test_marker.jpg测试如果能检测到，说明你原来的temp.jpg里的标记不符合要求。

• 检测参数不匹配
  默认检测参数对小尺寸、低分辨率的标记兼容性不好，可以调整以下参数优化检测效果：

parameters = aruco.DetectorParameters_create()
# 调整自适应阈值窗口大小
parameters.adaptiveThreshWinSizeMin = 3
parameters.adaptiveThreshWinSizeMax = 23
parameters.adaptiveThreshWinSizeStep = 4
# 调小最小标记周长阈值，适配小标记
parameters.minMarkerPerimeterRate = 0.03

• OpenCV版本兼容性问题
  OpenCV 4.7及以上版本重构了ArUco模块的API，旧的Dictionary_get、DetectorParameters_create方法已经被弃用，可能出现兼容问题，可替换为新API：

# 高版本OpenCV适配代码
aruco_dict = aruco.getPredefinedDictionary(aruco.DICT_5X5_250)
parameters = aruco.DetectorParameters()
detector = aruco.ArucoDetector(aruco_dict, parameters)
corners, ids, _ = detector.detectMarkers(gray)

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