远程执行PyInstaller生成的EXE时获取Windows当前用户目录的问题咨询

这问题我之前帮不少开发者排查过——当Jenkins以服务身份远程执行PyInstaller打包的EXE时，os.path.expanduser('~')和os.environ['USERPROFILE']返回的都是C:\Windows\System32\config\systemprofile，而非当前登录用户的Profile路径，核心原因是Jenkins默认使用**本地系统账户（Local System）**运行，程序继承了这个系统账户的上下文，而非交互式登录用户的上下文。下面给你几个实用的解决思路：

方法1：修改Jenkins服务的运行账户 #

最直接的方式是让Jenkins以当前登录用户的身份启动，这样程序运行时的环境变量会继承该用户的配置：

• 打开Windows服务管理器（按下Win+R输入services.msc）
• 找到Jenkins服务，右键选择「属性」
• 切换到「登录」标签页，选择「此账户」，输入当前交互式登录用户的账号和密码
• 点击「确定」后重启Jenkins服务

之后再执行你的EXE，os.environ['USERPROFILE']就能返回正确的用户路径了。注意：这个账户需要具备运行Jenkins服务的权限，必要时可以添加到本地管理员组。

方法2：用Windows API直接获取交互式用户的Profile路径 #

如果不想修改Jenkins服务的运行账户，可以通过ctypes调用Windows原生API，绕过环境变量直接获取当前登录用户的Profile路径。以下是完整的Python代码（打包时需确保ctypes被正确包含）：

import os
import ctypes
from ctypes import wintypes

def get_interactive_user_profile():
    """获取当前交互式登录用户的Profile路径，失败则 fallback 到默认方式"""
    buf = wintypes.LPWSTR()
    size = wintypes.DWORD(0)
    
    # 先获取所需缓冲区大小
    ctypes.windll.userenv.GetUserProfileDirectoryW(None, None, ctypes.byref(size))
    buf = ctypes.create_unicode_buffer(size.value)
    
    try:
        if ctypes.windll.userenv.GetUserProfileDirectoryW(None, buf, ctypes.byref(size)):
            return buf.value
        else:
            # API调用失败，返回默认路径
            return os.path.expanduser('~')
    finally:
        # 释放Windows API分配的内存
        if buf:
            ctypes.windll.kernel32.LocalFree(buf)

# 使用示例
user_profile = get_interactive_user_profile()
print(f"当前用户Profile路径：{user_profile}")

打包注意事项 #

PyInstaller打包时，可能需要在spec文件中指定hiddenimports确保ctypes.wintypes被正确打包：

# 在你的.spec文件中添加
hiddenimports=['ctypes.wintypes']

方法3：Jenkins远程执行时指定用户上下文 #

通过Jenkins插件或第三方工具，让EXE以指定用户身份运行，比如：

• 使用Credentials Binding插件配置目标用户的凭据，然后在构建步骤中以该用户身份执行命令
• 使用psexec工具远程调用（需提前在目标机器启用SMB服务）：

  psexec \\remote-computer -u target_username -p target_password "C:\path\to\your\app.exe"
  

这样程序运行在目标用户的上下文环境中，环境变量自然会指向正确的用户路径。

内容的提问来源于stack exchange，提问作者Michael Isaza