OpenCV视频模板匹配报错求助：matchTemplate返回(-215)错误

错误原因分析 #

你碰到的这个报错翻译成人话很直白：你用来匹配的模板图片尺寸，比视频里的帧尺寸还要大！

cv2.matchTemplate的工作逻辑是把模板像滑块一样在目标图像（视频帧）上滑动，逐像素计算匹配度——如果模板比目标帧还大，滑块根本没法在帧上滑动，自然就触发了这个尺寸校验的错误。

排查与解决步骤 #

1. 先确认尺寸问题

先在代码里加几行打印，明确你的模板和视频帧的实际尺寸：

# 读取模板后
template = cv2.imread('你的模板路径.jpg', cv2.IMREAD_GRAYSCALE)
print(f"模板尺寸：{template.shape[:2]}")

# 读取视频帧后
ret, frame = cap.read()
frame_gray = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)
print(f"视频帧尺寸：{frame_gray.shape[:2]}")

运行后就能直观看到是模板太大，还是视频帧过小。

2. 调整尺寸适配

最合理的解决方案是按比例缩小模板，让它能完整放进视频帧里（不推荐放大视频帧，会导致画质模糊）。这里给你修改后的完整代码示例：

import cv2
import numpy as np

cap = cv2.VideoCapture('ankhein.avi')
# 读取模板并转为灰度图（替换成你的模板实际路径）
template = cv2.imread('your_template_image.jpg', cv2.IMREAD_GRAYSCALE)

# 先检查模板是否读取成功
if template is None:
    print("Error: 模板图片读取失败，请检查路径是否正确！")
    exit()

templ_h, templ_w = template.shape[:2]

while cap.isOpened():
    ret, frame = cap.read()
    if not ret:
        break  # 视频读取完毕或出错
    
    frame_gray = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)
    frame_h, frame_w = frame_gray.shape[:2]
    
    # 检查尺寸是否符合匹配要求，不符合就调整模板
    if frame_h < templ_h or frame_w < templ_w:
        # 计算缩放比例，取能让模板刚好放进帧里的最大比例
        scale_factor = min(frame_h / templ_h, frame_w / templ_w)
        # 按比例缩小模板，INTER_AREA适合缩小图像，能保留更多细节
        template = cv2.resize(template, None, fx=scale_factor, fy=scale_factor, interpolation=cv2.INTER_AREA)
        templ_h, templ_w = template.shape[:2]
    
    # 现在可以安全执行模板匹配了
    res = cv2.matchTemplate(frame_gray, template, cv2.TM_CCOEFF_NORMED)
    
    # 后续处理：比如找到最佳匹配位置并绘制框
    _, max_val, _, max_loc = cv2.minMaxLoc(res)
    # 设定匹配阈值（比如0.8），超过阈值才认为匹配成功
    if max_val > 0.8:
        top_left = max_loc
        bottom_right = (top_left[0] + templ_w, top_left[1] + templ_h)
        cv2.rectangle(frame, top_left, bottom_right, (0, 255, 0), 2)
    
    cv2.imshow('Template Match Result', frame)
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

# 释放资源
cap.release()
cv2.destroyAllWindows()

额外注意事项

• 模板读取校验：如果模板路径错误，template会返回None，后续操作会触发其他错误，所以一定要加读取检查。
• 插值方法选择：缩小图像优先用cv2.INTER_AREA；如果特殊场景需要放大模板，可选用cv2.INTER_CUBIC或cv2.INTER_LINEAR。
• 帧尺寸波动：极少数视频会存在帧尺寸变化的情况，所以每次循环都检查尺寸是更稳妥的做法。

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