如何通过GitHub Actions生成CSV文件并上传至指定Box文件夹

你这个场景直接对接Box官方JWT服务账号是最稳定的方案，不需要额外安装桌面同步客户端，也不用依赖第三方中转工具，上传逻辑直接嵌在你现有的Python/R数据处理脚本里就行，和GitHub Actions的定时触发逻辑完全兼容。

Box端前置配置 #

• 登录Box开发者控制台，新建自定义应用，认证模式选择JWT服务账号认证——这个模式是专门给无人工交互的自动化场景设计的，不需要每次跑脚本都跳网页登录授权
• 应用创建完成后，生成JWT认证配置文件，保存好其中的client_id、client_secret、enterprise_id、jwt_key_id、RSA私钥内容、私钥密码这几个核心参数
• 打开你要存报表的目标Box文件夹，把刚创建的服务账号添加为文件夹协作者，授予上传/编辑权限，否则服务账号看不到目标文件夹，也没法上传文件
• 记录目标文件夹ID：在Box网页端打开目标文件夹时，URL里的那串纯数字就是文件夹唯一ID

代码实现 #

所有认证参数全部从系统环境变量读取，绝对不要把密钥硬编码在脚本里提交到代码仓库。

Python 版本 #

先安装官方SDK依赖：
pip install boxsdk
核心上传代码：

from boxsdk import JWTAuth, Client
import os

# 从环境变量读取认证配置
auth = JWTAuth(
    client_id=os.getenv("BOX_CLIENT_ID"),
    client_secret=os.getenv("BOX_CLIENT_SECRET"),
    enterprise_id=os.getenv("BOX_ENTERPRISE_ID"),
    jwt_key_id=os.getenv("BOX_JWT_KEY_ID"),
    rsa_private_key_data=os.getenv("BOX_RSA_PRIVATE_KEY"),
    rsa_private_key_passphrase=os.getenv("BOX_RSA_PASSPHRASE")
)
client = Client(auth)

# 替换为你自己的目标文件夹ID
target_folder = client.folder("你的目标文件夹数字ID").get()

# 遍历上传生成的报表文件，同名文件自动覆盖
for local_file in ["./output/result.csv", "./output/result.pdf"]:
    target_folder.upload(
        local_file,
        file_name=os.path.basename(local_file),
        preflight_check=True
    )

R 版本 #

先安装官方维护的boxr包：
install.packages("boxr")
核心上传代码：

library(boxr)

# 从环境变量读取认证配置
box_auth_service(
  client_id = Sys.getenv("BOX_CLIENT_ID"),
  client_secret = Sys.getenv("BOX_CLIENT_SECRET"),
  enterprise_id = Sys.getenv("BOX_ENTERPRISE_ID"),
  jwt_key_id = Sys.getenv("BOX_JWT_KEY_ID"),
  rsa_private_key = Sys.getenv("BOX_RSA_PRIVATE_KEY"),
  rsa_private_key_passphrase = Sys.getenv("BOX_RSA_PASSPHRASE")
)

# 替换为你自己的目标文件夹ID
target_dir_id <- "你的目标文件夹数字ID"

# 上传报表文件
box_ul(dir_id = target_dir_id, file = "./output/result.csv", pb = FALSE)
box_ul(dir_id = target_dir_id, file = "./output/result.pdf", pb = FALSE)

GitHub Actions 配置注意事项 #

• 把之前保存的所有JWT认证参数，全部添加到对应GitHub仓库的「Secrets and variables > Actions」配置里，工作流运行时会自动把这些值注入为脚本可读的环境变量
• 工作流的定时触发规则、数据拉取和报表生成逻辑不需要改动，只要在跑脚本的步骤前加上安装对应SDK/依赖包的步骤即可
• 如果你们企业的Box开了IP访问白名单，记得把GitHub Actions的公开出口IP段加到白名单里，不然会出现连接被拦截的问题

问题排查检索关键词 #

碰到配置问题可以直接用以下关键词检索解决方案：

• Box JWT服务账号 文件夹权限配置
• Python boxsdk 同名文件覆盖上传
• R boxr 服务账号认证报错
• GitHub Actions 密钥环境变量传递

内容的提问来源于stack exchange，提问作者Kelly-Anne Smith