
该错误源于 cv2.polylines() 要求输入点坐标必须为 int32 类型的二维数组,而 np.int8 不被接受;正确做法是使用 .astype(int) 或 .round().astype(int) 确保数据类型兼容且坐标为整数。
该错误源于 `cv2.polylines()` 要求输入点坐标必须为 `int32` 类型的二维数组,而 `np.int8` 不被接受;正确做法是使用 `.astype(int)` 或 `.round().astype(int)` 确保数据类型兼容且坐标为整数。
在 OpenCV 中,cv2.polylines() 是绘制多段折线(如旋转矩形轮廓)的常用函数,但它对输入坐标的数据类型(dtype)和维度结构有严格要求。你遇到的断言错误:
error: (-215:Assertion failed) p.checkVector(2, CV_32S) >= 0 in function 'cv::polylines'
明确指出:OpenCV 检查传入的点集 p 时,发现其不满足“二维、元素为 CV_32S(即 int32)”的要求。
问题代码中:
box = cv2.boxPoints(min_rect) # shape: (4, 2), dtype: float64 box = np.int8(box) # ❌ 错误:转为 int8,非 OpenCV 所需的 int32 cv2.polylines(frame, [box], True, (0, 255, 0), 2)
np.int8 虽为整数类型,但 OpenCV 内部仅接受 int32(即 np.int32 或等价的 int 在 64 位系统下通常映射为 int64,但 OpenCV 会自动转换为 int32 —— 前提是原始类型可安全转换)。更关键的是,np.int8 可能因溢出导致坐标截断(如坐标 >127 时变为负值),引发不可预知的绘图异常。
✅ 正确修复方式如下(推荐按优先级排序):
1. 推荐:先四舍五入再转 int(最鲁棒)
box = cv2.boxPoints(min_rect) box = np.round(box).astype(int) # ✅ float → round → int32(OpenCV 自动适配) cv2.polylines(frame, [box], True, (0, 255, 0), 2)
np.round() 处理浮点坐标的精度问题(如 100.9999 → 101.0),避免因截断导致顶点偏移。
2. 简洁替代:直接 astype(int)
box = cv2.boxPoints(min_rect).astype(int) # ✅ 多数场景足够安全
注意:astype(int) 默认执行向零取整(floor 对正数),对 boxPoints 输出(通常精度高、小数位极少)一般无影响,但仍不如 round() 严谨。
⚠️ 其他注意事项:
- 输入必须是嵌套列表或元组的数组:
[box]正确(表示单个多边形),box直接传入会报错(维度不符); -
box形状必须为(N, 2),cv2.boxPoints()返回的(4, 2)完全符合; - 避免使用
np.int8、np.uint8、np.float32等非标准类型——OpenCV 绘图函数对int32有强契约。
? 验证 dtype 的小技巧:
print(box.dtype) # 应输出 int32 或 int64(OpenCV 可接受) print(box.shape) # 应输出 (4, 2)
总结:此错误本质是类型契约不匹配,而非逻辑错误。牢记 OpenCV 绘图函数(polylines, polygon, line, circle 等)统一要求整数坐标以 int32 语义处理,始终用 .round().astype(int) 作为安全范式,即可彻底规避此类断言失败。

















