GitHub Actions自托管Windows Runner中COM接口保存Excel文件失败

在自托管Windows Runner上运行GitHub Actions工作流，通过Python的win32com调用Excel COM接口创建文件时，本地运行正常，但工作流中执行SaveAs方法报错，错误信息如下：

pywintypes.com_error: (-2147352567, 'Exception occurred.', (0, 'Microsoft Excel', 'SaveAs method of Workbook class failed', 'xlmain11.chm', 0, -2146827284), None)

用户的工作流YAML配置：

name: test
run-name: test
on: [push]
jobs:
  create-excel:
    runs-on: self-hosted
    steps:
      - name: Check out repository
        uses: actions/checkout@v3
      - name: Create excel
        run: python create_excel.py

Python脚本代码：

import os
import win32com.client as win32

excel = win32.Dispatch("Excel.Application")
workbook = excel.Workbooks.Add()
workbook.SaveAs(os.getcwd() + '\\Created.xlsx')
workbook.Close()
excel.Quit()

可能的解决方案 #

1. 调整Runner的运行模式 #

GitHub Actions Runner默认以Windows服务运行，服务账户无桌面交互权限，而Excel COM对象依赖桌面会话才能正常执行保存操作：

• 打开Windows服务管理器，找到GitHub Actions Runner服务
• 右键选择「属性」，切换到「登录」选项卡
• 选择「此账户」，输入拥有本地管理员权限且支持交互登录的账户
• 勾选「允许服务与桌面交互」，重启服务后重新运行工作流

2. 使用明确的工作目录路径 #

os.getcwd()在Runner环境中可能指向Runner安装目录，而非仓库工作目录，容易引发权限不足问题。改用GitHub提供的环境变量GITHUB_WORKSPACE指定保存路径：
修改后的Python脚本：

import os
import win32com.client as win32
import gc

excel = win32.Dispatch("Excel.Application")
excel.Visible = False  # 隐藏Excel窗口，避免交互冲突
workbook = excel.Workbooks.Add()
# 用GITHUB_WORKSPACE指定仓库工作目录
file_path = os.path.join(os.environ['GITHUB_WORKSPACE'], 'Created.xlsx')
workbook.SaveAs(file_path, FileFormat=51)  # 51对应xlsx格式
workbook.Close()
excel.Quit()
# 强制释放COM对象，避免残留进程
gc.collect()

3. 明确指定Excel保存格式 #

Excel的SaveAs方法需明确指定文件格式，不同环境下默认格式可能不兼容。常用格式代码：

• 51: .xlsx格式
• 52: .xlsm格式
• 56: .xls格式
  在SaveAs调用时添加FileFormat参数即可解决格式不匹配导致的报错。

4. 验证权限配置 #

• 确认Runner运行账户对目标保存目录（如仓库工作目录）拥有读写权限
• 检查Excel信任中心设置，确保未禁用COM对象操作（本地运行正常则此概率较低）

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