Windows环境下Golang使用GoCV调用MatchTemplate函数触发异常求助

本质是C层OpenCV接收到非法输入触发的CGO调用崩溃，常见触发原因如下：

• 图片读取失败：未校验IMRead返回结果，若文件路径错误、文件损坏，会返回空Mat，传入C侧OpenCV直接触发空指针崩溃
• 图像格式不匹配：IMReadUnchanged会保留原图的通道数（如带透明通道的PNG会返回4通道BGRA），若两张输入图的通道数、位深不一致，MatchTemplate会触发底层异常
• 模板尺寸大于源图：待匹配的小图（needle）宽/高大于原图（haystack），不符合MatchTemplate的输入要求
• 带透明通道的PNG适配问题：OpenCV原生MatchTemplate对带alpha通道的图像处理存在兼容性问题，容易触发异常

1. 新增图片读取结果校验，确认输入Mat非空再执行后续逻辑
2. 统一两张图的色彩空间，建议统一转为单通道灰度图或者3通道BGR图，剔除alpha通道影响
3. 提前校验模板尺寸，确保模板宽高均小于等于源图
4. 新增Mat资源释放逻辑，避免内存泄漏

func main() {
    // 读取源图和模板图
    haystackImg := gocv.IMRead("./test.png", gocv.IMReadUnchanged)
    defer haystackImg.Close()
    needleImg := gocv.IMRead("./test2.png", gocv.IMReadUnchanged)
    defer needleImg.Close()

    // 校验图片是否读取成功
    if haystackImg.Empty() || needleImg.Empty() {
        panic("图片读取失败，请检查文件路径是否正确")
    }

    // 统一转为灰度图，消除通道差异
    gocv.CvtColor(haystackImg, &haystackImg, gocv.ColorBGRAToGray)
    gocv.CvtColor(needleImg, &needleImg, gocv.ColorBGRAToGray)

    // 校验模板尺寸不大于源图
    if needleImg.Cols() > haystackImg.Cols() || needleImg.Rows() > haystackImg.Rows() {
        panic("模板图尺寸不能大于源图")
    }

    result := gocv.NewMat()
    defer result.Close()
    mask := gocv.NewMat()
    defer mask.Close()

    // 执行模板匹配
    gocv.MatchTemplate(haystackImg, needleImg, &result, gocv.TmCcoeffNormed, mask)

    // 归一化结果，方便展示和后续阈值判断
    gocv.Normalize(result, &result, 0, 1, gocv.NormMinMax, -1, gocv.NewMat())

    window := gocv.NewWindow("匹配结果")
    defer window.Close()

    for {
        window.IMShow(result)
        if window.WaitKey(1) == 27 { // 按ESC键退出程序
            break
        }
    }
}

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