使用Alire执行alr edit启动Gnat Studio失败崩溃问题咨询

问题对应报错特征 #

执行alr edit启动GNAT Studio时程序直接崩溃，日志输出如下错误：

[PROJECTS.EXCEPTIONS] Unexpected exception: raised CONSTRAINT_ERROR : gnatcoll-projects.adb:5729 index check failed _PROJECTS.EXCEPTIONS_ [C:\GNATSTUDIO\bin\gps.libgnatcoll\libgnatcoll.dll] _PROJECTS.EXCEPTIONS_ 0x7ffc78dcecb8 ??? at ???

程序启动阶段提示进入「不一致状态」后强制退出。

排查步骤 #

• 先确认版本兼容性：分别在终端执行alr --version、gnatstudio --version核对版本号，该报错的核心触发原因基本都是GNAT Studio和Alire当前激活的GNAT工具链版本不匹配。Alire会为每个项目沙箱独立拉取对应版本的GNAT编译器、gnatcoll项目处理库，如果你本地独立安装的GNAT Studio和沙箱内工具链大版本差超过1，启动时就会加载到接口不匹配的dll，解析项目文件时触发数组越界，刚好命中gnatcoll里的索引检查断言。
• 检查项目本地缓存：进入项目根目录，查看alire/cache目录、根目录自动生成的gpr链接文件、obj目录下的项目临时配置是否存在损坏，旧版本依赖残留、中断操作生成的残缺配置都会导致项目解析失败。
• 检查环境变量冲突：Windows环境下执行set PATH查看当前终端的路径列表，确认是否同时存在多个GNAT版本的bin目录——比如全局安装的GNAT社区版路径、Alire缓存的工具链路径同时存在，路径优先级不对时GNAT Studio会加载错误版本的依赖dll。
• 开启调试日志定位具体触发点：执行alr edit --debug复现问题，拉取完整启动日志，查看项目加载阶段最后一条记录对应的文件，部分存在语法错误的自定义gpr配置、路径不存在的依赖引用也会触发该类索引越界错误。

修复方案 #

• 版本不匹配问题：最稳妥的方案是不要用独立安装的GNAT Studio，直接在Alire项目环境内执行alr with gnatstudio，安装和当前沙箱工具链完全匹配的GNAT Studio版本，后续执行alr edit会自动调用沙箱内的程序，不会出现dll不匹配问题。如果必须使用本地独立安装的GNAT Studio，执行alr toolchain --select选择和本地GNAT Studio版本完全一致的GNAT工具链作为项目默认版本即可。
• 缓存损坏问题：删除alire/cache目录、根目录下自动生成的.gpr临时文件、obj目录下所有配置缓存，先执行alr build完成一次完整依赖拉取和项目生成，再执行alr edit启动，不要在未完成首次构建的项目上直接调用edit命令。
• 环境变量冲突问题：启动Alire终端前不要提前加载其他GNAT版本的环境变量，如果系统全局PATH里配置了其他GNAT版本的bin路径，临时移除后重启Alire终端重试；也可以修改Alire全局配置，关闭Alire.Environment.Passthrough选项，避免全局环境变量污染Alire沙箱的独立环境。
• 配置错误问题：如果调试日志定位到是自定义gpr文件触发的错误，逐一检查gpr文件内的Source_Dirs、Languages、with依赖项，修正空列表、不存在的路径引用、语法错误后重新启动即可。

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