AWS CodeBuild部署报错：跳过无效工件路径（非有效标识符）

我之前也碰到过类似的CodeBuild工件配置坑，这种"Skipping invalid artifact path"报错大多是buildspec里的路径规则不符合CodeBuild的要求，咱们一步步来定位问题：

• 先检查buildspec.yml的artifacts配置格式
  CodeBuild对工件路径的要求很严格，尤其是通配符和相对路径的使用。比如你当前的配置如果是：

  artifacts:
    files:
      - bundles/*
  

  要注意两个关键点：

  • 路径必须是相对于CodeBuild工作目录（默认是/codebuild/output/srcXXX/src/）的相对路径，绝对不能加开头的斜杠（比如/bundles/*会被判定为无效路径）。
  • 如果bundles目录下还有子文件夹，需要用bundles/**/*来递归匹配所有文件，否则只会打包bundles下的直接文件。

• 确认路径中没有特殊字符
  报错里的"not a valid identifier"提示，大概率是你的bundles目录名或者里面的ZIP文件名包含了特殊字符（比如空格、中文、@、#这类）。CodeBuild的工件路径标识符只支持英文、数字、下划线和连字符，建议把文件名改成合规格式再重新构建。

• 试试添加base-directory配置
  如果你的目标是把bundles目录下的所有ZIP作为工件，而不是把bundles目录本身打包，建议在artifacts里加上base-directory：

  artifacts:
    base-directory: bundles
    files:
      - '**/*'
  

  这样CodeBuild会把bundles作为工件的根目录，直接打包里面的所有内容，避免路径识别混乱。

• 在构建日志里验证文件实际位置
  可以在buildspec的post_build阶段加几个调试命令，确认文件真的在预期路径里：

  post_build:
    commands:
      - echo "=== 检查bundles目录结构 ==="
      - ls -la ./bundles/
      - find . -name "*.zip" -type f
  

  查看CodeBuild的构建日志，确认ZIP文件确实出现在./bundles/路径下——有时候构建脚本可能把文件生成到了其他目录，自己却没注意到。

• 最后检查CodeBuild项目的工件存储权限
  虽然报错是路径问题，但也有可能是CodeBuild没有权限访问你配置的工件存储（比如S3桶）。可以去CodeBuild项目的"Artifacts"设置里，确认S3桶名称和前缀正确，并且CodeBuild的服务角色有读写该桶的权限。

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