使用GitHub Actions向Sentry上传调试文件遇权限错误求助

问题背景 #

在GitHub Actions的macos-13环境中，执行xcodebuild test后使用sentry-cli上传DSYM调试文件时，遭遇Permission denied (os error 13)错误，调整目录权限无效，且无法在构建阶段上传（需保护Sentry令牌不暴露）。

解决步骤 #

1. 验证DSYM路径与文件权限 #

首先确认目标DSYM文件的实际状态，避免路径错误或文件不存在导致的权限假象：

# 打印路径并检查文件详情
echo "Target DSYM path: $DWARF_DSYM_FOLDER_PATH/$DWARF_DSYM_FILE_NAME"
ls -ld "$DWARF_DSYM_FOLDER_PATH"
ls -la "$DWARF_DSYM_FOLDER_PATH/$DWARF_DSYM_FILE_NAME"

若路径不存在，说明模拟器构建的DSYM可能存放在~/Library/Developer/Xcode/DerivedData/目录下，可通过查找命令定位：

# 查找最新生成的DSYM目录
DSYM_PATH=$(find ~/Library/Developer/Xcode/DerivedData -name "*.dSYM" -type d | sort -r | head -1)
echo "Found DSYM at: $DSYM_PATH"

将上述$DSYM_PATH作为sentry-cli的上传路径。

2. 修正sentry-cli执行上下文与路径格式 #

macos-13 runner中，直接拼接路径可能因特殊字符或权限上下文报错，需做以下调整：

• 用引号包裹路径，避免空格或特殊字符解析错误：

sentry-cli debug-files upload --auth-token ${{ secrets.SENTRY_AUTH_TOKEN }} \
--include-sources \
--org myorg \
--project myproject \
"$DWARF_DSYM_FOLDER_PATH/$DWARF_DSYM_FILE_NAME"

• 重新安装并确保sentry-cli可执行权限：

brew reinstall sentry-cli
chmod +x $(which sentry-cli)

3. 改用Sentry官方GitHub Action（推荐） #

Sentry官方提供的action-dsym已适配GitHub Actions环境，自动处理权限与路径问题，且安全使用secrets：

- name: Upload DSYM to Sentry
  uses: getsentry/action-dsym@v1
  with:
    auth_token: ${{ secrets.SENTRY_AUTH_TOKEN }}
    org: myorg
    project: myproject
    dsym_path: ${{ env.DWARF_DSYM_FOLDER_PATH }}/${{ env.DWARF_DSYM_FILE_NAME }}

4. 复制DSYM到临时目录规避原目录权限限制 #

若原DSYM所在目录（如DerivedData）存在系统级权限限制，可先复制到自定义临时目录再上传：

# 创建临时目录并复制DSYM
mkdir -p ./temp-dsym
cp -R "$DWARF_DSYM_FOLDER_PATH/$DWARF_DSYM_FILE_NAME" ./temp-dsym/
chmod -R 755 ./temp-dsym

# 从临时目录上传
sentry-cli debug-files upload --auth-token ${{ secrets.SENTRY_AUTH_TOKEN }} \
--include-sources \
--org myorg \
--project myproject \
./temp-dsym/

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