GitLab CI问题：工件提取后隐藏文件无法显示

常见原因及对应解决办法 #

1. 工件归档时未包含隐藏文件 #

GitLab CI的artifacts:paths默认使用shell glob匹配规则，不会自动包含以.开头的隐藏文件/目录。如果配置里只指定普通文件路径，隐藏文件会被遗漏。

解决办法：

• 在paths中明确添加隐藏文件的匹配规则：

  artifacts:
    paths:
      - .*          # 匹配所有隐藏文件和目录
      - *           # 匹配所有非隐藏文件和目录
      # 也可以指定具体隐藏项，比如 .env、.config/ 等更精确的路径
  

2. 误配置artifacts:exclude排除了隐藏文件 #

如果流水线中设置了artifacts:exclude规则，可能不小心将所有隐藏文件（如.*）纳入排除范围，导致归档时被过滤。

解决办法：

• 检查exclude配置，移除或调整针对隐藏文件的排除规则。例如：

  artifacts:
    paths:
      - .*
      - *
    exclude:
      - .git/       # 只排除不需要的隐藏目录，而非所有隐藏项
  

3. 隐藏文件权限问题 #

归档的隐藏文件可能带有严格的权限设置（如仅所有者可读），提取后当前运行用户没有读取权限，导致无法显示。

解决办法：

• 在归档前或提取后修复权限：
  • 归档时设置权限：在生成工件的脚本中添加权限调整命令

    chmod -R 644 .*  # 让所有隐藏文件可被读取
    

  • 提取后修复：在使用工件的步骤中添加权限修复

    test_job:
      script:
        - ls -la  # 先确认是否存在
        - chmod -R 755 .*
        - ls -la  # 再次验证
    

4. 自定义归档脚本未包含隐藏文件 #

如果使用自定义脚本（如tar）打包工件，默认情况下tar不会包含隐藏文件，需要显式指定参数。

解决办法：

• 使用tar的--hidden参数包含隐藏文件：

  tar --hidden -czf artifacts.tar.gz ./src .env .config
  

• 然后在artifacts:paths中指定这个打包文件，后续步骤解压时就能得到所有隐藏文件。

验证步骤 #

• 在归档工件的job中添加ls -la或tar tvf <artifact-file>命令，确认隐藏文件已被包含在归档内
• 在提取工件的job中，先执行ls -la查看文件列表，确认问题出在归档还是提取环节

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