terrascan pre-commit hook无策略违规返回退出码4怎么解决

1. 明确退出码含义 #

terrascan返回退出码4不属于策略违规类报错，而是代表扫描流程本身出现异常，包括路径读取失败、文件解析错误、权限不足、路径映射错误等，这类异常不会被统计到违规策略计数中，因此会出现扫描结果显示0违规但执行失败的情况。
你输出中同时出现了WSL路径/mnt/c/azure_modules/...和Linux路径/azure_modules/...，大概率是跨环境路径映射冲突导致的扫描异常。

2. 手动运行terrascan定位具体错误 #

不要通过pre-commit调用，直接在项目根目录执行带详细日志的扫描命令，查看具体报错信息：

terrascan scan -i terraform -d ./ -v

-v参数会输出verbose级别的日志，可以直接定位到是哪个文件/路径出现解析或读取错误。

3. 调整pre-commit的terrascan配置 #

在你的.pre-commit-config.yaml中给terrascan hook补充参数，规避扫描异常：

- id: terrascan
  args:
    - --scan-type=terraform
    - --dir=./
    - --skip-path=./examples # 不需要扫描示例目录时可添加，避免重复扫描
    - --non-recursive # 不需要递归扫描子目录时可添加

如果确认扫描异常不影响核心代码校验，也可以添加参数强制忽略扫描过程错误：

args:
  - --exit-code-on-error=0

4. 修复版本兼容性问题 #

你使用的antonbabenko/pre-commit-terraform v1.51.0对应绑定的terrascan版本较旧，存在无违规返回退出码4的已知bug，可以将该repo的rev升级到最新稳定版，即可解决版本自带的缺陷问题。

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