Halcon 9.0在Windows 10通过Squish启动报错求助（Windows 8.1正常）

我之前帮团队排查过几乎一模一样的问题——用Squish启动依赖Halcon的Qt应用时，Win8.1一切正常，Win10 CI环境就触发Halcon初始化报错，分享几个我们验证有效的排查方向和解决办法：

1. 补全Squish启动时缺失的环境变量 #

Squish的启动器（包括startaut）不会默认继承完整的系统环境变量，而Halcon对HALCONROOT、HALCONARCH以及依赖库路径的依赖极强。我们的解决办法是：

• 在CI脚本启动Squish前，手动设置必要的环境变量：

set HALCONROOT=C:\Program Files\MVTec HALCON\9.0
set HALCONARCH=win64
set PATH=%HALCONROOT%\bin\%HALCONARCH%;%PATH%
set PATH=C:\Qt\5.9\msvc2015_64\bin;%PATH%

• 或者在Squish测试用例的初始化阶段，通过代码注入环境变量（以Python测试脚本为例）：

import os

def setup():
    os.environ["HALCONROOT"] = "C:\\Program Files\\MVTec HALCON\\9.0"
    os.environ["HALCONARCH"] = "win64"
    halcon_bin_path = os.path.join(os.environ["HALCONROOT"], "bin", os.environ["HALCONARCH"])
    os.environ["PATH"] = f"{halcon_bin_path};{os.environ['PATH']}"
    # 同时补全Qt的bin路径
    os.environ["PATH"] = f"C:\\Qt\\5.9\\msvc2015_64\\bin;{os.environ['PATH']}"

2. 规避Squish Hook与Halcon初始化的冲突 #

Squish会注入Qt Hook来捕获UI控件，这可能干扰Halcon的底层初始化逻辑（比如OpenGL/DirectX上下文的创建）。我们尝试了两种有效方式：

• 延迟Halcon初始化：把Halcon的初始化代码从main函数中移出，放到Qt事件循环启动后执行，比如：

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);
    MainWindow w;
    w.show();
    // 延迟初始化Halcon，让Qt完全启动
    QTimer::singleShot(0, [](){
        // 这里写Halcon的初始化代码，比如HSystem::init()
    });
    return a.exec();
}

• 调整Squish的Hook时机：在Squish的测试套件设置中，找到“Application Settings”，尝试勾选“Delay hook injection until main window is shown”选项，避免在应用初始化阶段就注入Hook。

3. 检查Win10 CI环境的权限与资源访问 #

CI环境通常使用服务账户或低权限用户运行，而Halcon可能需要访问显卡驱动、特定系统目录或注册表项：

• 给CI运行账户添加Halcon安装目录（包括bin、lib、data文件夹）的读写权限；
• 尝试以管理员身份启动Squish的startaut工具，或者在CI脚本中添加runas /user:Administrator "startaut.exe ..."；
• 临时调低Win10的UAC级别（仅测试用，测试通过后再调整回来），排除权限拦截的可能。

4. 排查依赖库加载差异 #

用Windows的Process Monitor工具对比手动启动和Squish启动时的文件访问日志：

• 过滤Halcon相关的dll文件（比如halcon.dll、hdevengine.dll），看是否有“找不到文件”或“访问被拒绝”的记录；
• 重点检查Squish启动时是否加载了错误版本的依赖库（比如系统目录下的旧版本Qt dll覆盖了应用自带的版本）。

5. 考虑Halcon版本兼容性 #

Halcon 9.0是比较老旧的版本（发布于2012年左右），对Win10的兼容性支持有限。如果前面的方法都无效，可以尝试升级Halcon到支持Win10的版本（比如12.x及以上）——虽然需要适配代码，但能从根本上解决这类兼容性问题。

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