使用EXPO CLI构建Android预览版APK时压缩文件报错求解决

算力阿峰

2026-8-7

解决EAS Build压缩阶段报错“Cannot copy a socket file”的方案

问题原因

这个错误并非应用代码本身的问题，是EAS Build在打包项目文件时，意外遍历到了用户系统目录下的Zoom应用容器文件（/Users/mac/Library/Group Containers/BJ4HAAB9B3.ZoomClient3rd/s.zzhost是Zoom的socket文件），这类特殊文件无法被复制压缩，导致构建终止。

解决方案

配置文件忽略规则：在项目根目录创建或修改.easignore（优先于.gitignore生效），添加以下规则排除系统目录扫描：
```
**/Library/Group Containers/**
**/*.sock
```
若已有.gitignore，直接在其中追加上述规则也可，EAS会默认读取.gitignore的配置。
精准指定构建包含文件：在eas.json的preview配置项中，添加buildArtifactPaths字段，明确列出需要打包的文件/目录，避免扫描无关路径：
```
"preview": {
  "android": {
    "buildArtifactPaths": ["package.json", "app.json", "src/**/*", "assets/**/*", "node_modules/**/*"]
  }
}
```
清理EAS构建缓存：执行命令清除本地和远程缓存，让EAS重新扫描项目文件：
```
eas build:clear-cache
```
检查项目软链接：如果项目根目录存在指向~/Library或其他系统目录的软链接，直接删除这类链接，避免EAS扫描到系统文件。