基于GitHub Enterprise的已打包Python GUI程序自动更新实现方案咨询

看起来你已经摸准了自动更新的核心思路，只是在GitHub Enterprise的认证、文件下载替换环节踩了坑，我来一步步帮你梳理解决方案和优化实践：

一、先搞定版本检测的核心逻辑 #

首先要确保能准确对比本地和远程的版本号，你已经有version.txt的基础，只需要加上GitHub API的认证请求：

• 程序启动时先读取本地version.txt的版本号（比如1.0.2）
• 通过GitHub Enterprise API请求远程版本文件，必须带上你的API Token才能访问私有仓库资源，示例代码：

import requests
import base64

GHE_API_URL = "https://github.build.company/api/v3/repos/user/repo/contents/version.txt"
HEADERS = {"Authorization": "token YOUR_GHE_API_TOKEN"}

def get_remote_version():
    try:
        resp = requests.get(GHE_API_URL, headers=HEADERS)
        resp.raise_for_status()  # 主动抛出HTTP错误方便排查
        # GitHub API返回的文件内容是base64编码的，需要解码
        content = base64.b64decode(resp.json()["content"]).decode("utf-8").strip()
        return content
    except Exception as e:
        print(f"获取远程版本失败: {e}")
        return None

# 读取本地版本
local_version = open("version.txt", "r").read().strip()
remote_version = get_remote_version()

# 版本对比，触发更新流程
if remote_version and remote_version > local_version:
    # 这里替换成你的GUI弹窗询问逻辑
    if confirm_update():
        start_update_process()

二、解决EXE下载的两个关键问题 #

1. 认证失败（Releases链接返回HTML） #

你用Releases下载链接时返回认证页面，是因为没有在请求头里携带API Token。正确的下载代码应该是：

def download_new_exe():
    # 替换成你对应Release版本的EXE下载链接
    exe_download_url = "https://github.build.company/user/repo/releases/download/v1.0.3/program.exe"
    try:
        # 用stream=True处理大文件，避免内存占用过高
        resp = requests.get(exe_download_url, headers=HEADERS, stream=True)
        resp.raise_for_status()
        # 注意：不要直接覆盖正在运行的program.exe，先下载到临时文件
        with open("program_new.exe", "wb") as f:
            for chunk in resp.iter_content(chunk_size=8192):
                f.write(chunk)
        return True
    except Exception as e:
        print(f"下载更新失败: {e}")
        return False

2. WinError 193的问题 #

你用raw/main/dist/program.exe链接下载后出现这个错误，主要原因有两个：

• GitHub的raw链接对于二进制文件，如果没有用二进制模式写入，或者请求时误将响应按文本解析，会破坏EXE的二进制结构
• 更关键的是：不要把打包好的EXE放在主分支的dist目录里，主分支应该只存源码和打包配置，打包产物放在Releases里更规范，既避免源码分支臃肿，也能通过Releases API更可靠地管理版本

三、处理EXE替换的核心：不能覆盖正在运行的程序 #

直接下载覆盖program.exe会失败，因为程序运行时文件会被系统锁定。解决方法是做一个轻量更新器脚本：

1. 主程序检测到更新后，启动单独打包的更新器（比如updater.exe），然后立即退出主进程
2. 更新器等待主进程完全结束后，下载新EXE、替换旧文件，最后启动新程序
   示例更新器核心代码：

import os
import time
import subprocess
import requests

HEADERS = {"Authorization": "token YOUR_GHE_API_TOKEN"}

def wait_for_main_process():
    # 等待主程序进程结束，根据主程序的进程名判断
    while True:
        try:
            subprocess.check_output(["tasklist", "/FI", "IMAGENAME eq program.exe"], shell=True)
            time.sleep(1)
        except subprocess.CalledProcessError:
            # 主进程已退出
            break

def replace_and_restart():
    # 下载新EXE到临时文件
    if download_new_exe():
        # 替换旧文件
        os.remove("program.exe")
        os.rename("program_new.exe", "program.exe")
        # 启动新程序
        subprocess.Popen(["program.exe"])

if __name__ == "__main__":
    wait_for_main_process()
    replace_and_restart()

四、更规范的发布实践 #

1. 用GitHub Releases管理版本：
   • 每次更新后打一个语义化版本的tag（比如v1.0.3）
   • 把打包好的program.exe、version.txt上传到对应Release，也可以直接在Release描述里标注版本号
   • 通过https://github.build.company/api/v3/repos/user/repo/releases/latest API获取最新Release信息，自动拿到下载链接，不用手动维护
2. 不要把打包产物提交到主分支：主分支只保存源码和打包配置（比如pyinstaller的.spec文件），避免仓库体积膨胀
3. API Token权限最小化：给你的GHE API Token只开repo权限，不要给不必要的权限，降低安全风险

备注：内容来源于stack exchange，提问作者Mariano Gongora