macOS使用gocv时间歇性触发NSInternalInconsistencyException异常求助

问题描述 #

使用gocv编写的代码，从接口获取数据后在图片上绘制矩形并显示，代码如下：

func main() {
resp, err := http.Get("http://localhost:6060/template-match")
if err != nil {
    panic(err)
}

defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
    panic(err)
}
fmt.Println(string(body))
var data Response
err = json.Unmarshal(body, &data)
if err != nil {
    panic(err)
}
srcImage := gocv.IMRead("./images/src1.jpg", gocv.IMReadColor)
for i := 0; i < len(data.Data); i++ {
    gocv.Rectangle(&srcImage, data.Data[i], color.RGBA{R: 255}, 2)
}
window := gocv.NewWindow("match-result")
window.IMShow(srcImage)
gocv.WaitKey(0)
fmt.Println(data.Data, data.Msg)
}

运行时间歇性出现错误：

Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'NSWindow drag regions should only be invalidated on the Main Thread!'

错误原因 #

这是macOS UI框架的硬性限制：所有与NSWindow相关的操作必须在主线程执行。Go的goroutine调度器会随机分配任务到不同线程，当窗口创建、显示等操作被分配到非主线程时就会触发该错误；若刚好分配到主线程则程序正常运行，因此错误表现为间歇性出现。

解决方案 #

将所有窗口相关的UI操作强制绑定到主线程执行，利用Go的runtime.LockOSThread()方法锁定当前goroutine到主线程，确保UI操作全部在主线程完成。修改后的代码如下：

import (
    "encoding/json"
    "fmt"
    "image/color"
    "io/ioutil"
    "net/http"
    "runtime"

    "gocv.io/x/gocv"
)

type Response struct {
    Data []image.Rectangle
    Msg  string
}

func main() {
    // 先执行非UI逻辑：接口请求、图片绘制
    resp, err := http.Get("http://localhost:6060/template-match")
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }
    fmt.Println(string(body))

    var data Response
    err = json.Unmarshal(body, &data)
    if err != nil {
        panic(err)
    }

    srcImage := gocv.IMRead("./images/src1.jpg", gocv.IMReadColor)
    defer srcImage.Close() // 释放图片资源
    for _, rect := range data.Data {
        gocv.Rectangle(&srcImage, rect, color.RGBA{R: 255}, 2)
    }

    // 锁定当前goroutine到主线程，执行UI操作
    runtime.LockOSThread()
    defer runtime.UnlockOSThread()

    window := gocv.NewWindow("match-result")
    defer window.Close() // 释放窗口资源
    window.IMShow(srcImage)
    gocv.WaitKey(0)

    fmt.Println(data.Data, data.Msg)
}

关键修改点： #

• 拆分逻辑：将接口请求、图片处理等非UI操作前置，避免主线程阻塞
• 线程锁定：用runtime.LockOSThread()确保后续窗口操作都在主线程执行
• 资源释放：添加defer语句释放图片和窗口资源，防止内存泄漏

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