Spring Boot项目中Gitleaks预提交钩子未检测到密钥问题排查

1. 修正钩子扫描目标配置 #

你当前配置中指定的detect参数会让Gitleaks执行全仓库扫描，但pre-commit框架下的钩子默认应仅扫描暂存区文件，两者逻辑冲突可能导致漏检。移除detect参数，让钩子使用默认行为：

repos:
  - repo: https://github.com/zricethezav/gitleaks
    rev: v8.17.0
    hooks:
      - id: gitleaks
        # 删除args: [detect]，恢复默认暂存文件扫描逻辑

2. 覆盖AWS临时密钥检测规则 #

ASIAT开头的是AWS临时访问密钥，部分旧版本Gitleaks的默认规则未覆盖该格式。可在项目根目录创建gitleaks.toml添加自定义规则：

[[rules]]
id = "aws-temporary-access-key"
description = "AWS Temporary Access Key"
regex = '''AKIA|ASIA[0-9A-Z]{16}'''
secretGroup = 1
keywords = ["aws", "access", "key", "temporary", "asiat"]

然后在钩子配置中指定规则文件：

repos:
  - repo: https://github.com/zricethezav/gitleaks
    rev: v8.17.0
    hooks:
      - id: gitleaks
        args:
          - detect
          - --config=gitleaks.toml

3. 强制扫描暂存区文件 #

若坚持使用detect命令，需添加--staged参数明确扫描暂存区，与pre-commit逻辑对齐：

repos:
  - repo: https://github.com/zricethezav/gitleaks
    rev: v8.17.0
    hooks:
      - id: gitleaks
        args:
          - detect
          - --staged

4. 本地独立测试验证 #

脱离pre-commit框架，直接运行Gitleaks排查问题：

# 扫描目标配置文件
gitleaks detect --path=子项目路径/application.yml
# 扫描Git暂存区
gitleaks detect --staged

若直接运行能检测到密钥，说明是pre-commit钩子配置问题；若仍检测不到，需进一步调整规则。

5. 更新Gitleaks版本 #

v8.17.0属于较旧版本，新版本对AWS密钥的规则覆盖更全面。尝试将rev更新至最新稳定版（如v8.21.1）后重新测试。

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