网通社科技快报

DicomViewer24 Windows编译修复从超时到插件缺失的全面解决

近日,开源医学影像处理软件DicomViewer24在GitHub CI流程中遭遇Windows平台编译失败问题。该问题最初表现为CI测试耗时52分钟,远超设定的47分钟超时限制,并伴随测试程序运行错误。经过深入排查,开发团队发现核心问题在于Windows环境与Linux/WSL环境的差异,具体包括超时设置无效、缺少必要的Qt插件(如offscreen插件)以及CMake对Windows平台支持不足。为彻底解决这些问题,团队采取了以下关键措施:首先,在本地使用VSCode的CMake工具进行调试,通过修改CMakePresets.json文件固定相关参数,确保构建环境一致性;其次,针对测试超时问题,团队单独运行ViewMode_test.exe进行测试重现,发现单纯延长超时时间无法解决问题,最终确认是Qt插件缺失所致;最后,团队在CMakeLists.txt中添加自动部署Qt插件的逻辑,采用整目录拷贝方式替代逐个DLL文件部署,确保所有必要插件正确加载。通过上述调整,新的构建流程不仅避免了超时错误,还确保所有测试用例顺利通过。此次修复过程充分展示了跨平台开发中环境一致性的重要性,为后续类似问题的排查提供了宝贵经验。