如何在GitLab CI（Windows运行器）中正确运行cabal解决依赖问题？

算力阿峰

2026-7-26

解决GitLab CI Windows运行器上Cabal依赖解析失败问题

你遇到的问题本质是Cabal未成功获取Hackage包索引，或是索引状态异常导致无法识别依赖包。以下是针对性修复步骤：

强制清理并重新生成包索引
Windows环境下Cabal的包索引默认存于%APPDATA%\cabal\packages目录，旧的损坏索引会导致cabal update失效。在CI脚本中添加以下命令：
```
# 强制删除旧索引目录（忽略删除失败的情况）
Remove-Item -Recurse -Force $env:APPDATA\cabal\packages -ErrorAction SilentlyContinue
# 带详细日志执行update，便于排查下载问题
cabal update -v3
```
执行后查看日志，确认是否成功下载Hackage索引文件。
验证CI环境的网络连通性
GitLab Windows运行器可能被防火墙或代理拦截了Hackage的访问。在CI脚本中添加网络测试：
```
Invoke-WebRequest -Uri https://hackage.haskell.org/packages/index.tar.gz -OutFile index.tar.gz
```
如果下载失败，需联系运维团队开放对hackage.haskell.org的HTTPS（443端口）访问权限。
调整依赖版本约束
aeson-default-0.9.1.2依赖的Aeson版本可能过于陈旧，已从Hackage活跃索引中移除。可在项目根目录的cabal.project文件中添加版本约束：
```
constraints: aeson >= 1.0 && < 2.0
```
或直接在项目的.cabal文件中明确指定Aeson的兼容版本范围，匹配aeson-default的依赖需求。
升级Cabal到最新稳定版
旧版本Cabal可能不兼容当前Hackage索引格式。在CI脚本中先升级Cabal：
```
cabal install cabal-install --overwrite-policy=always
```
升级完成后，重新执行cabal update和构建命令。