使用PyInstaller打包Python脚本为exe后无法运行的问题排查

这个错误的核心原因是：PyInstaller打包成--onefile后，undetected_chromedriver启动的子进程会重新运行整个EXE文件，导致主脚本中的argparse再次执行参数解析，但子进程并未收到--user/--password参数，从而触发"参数缺失"的报错。同时子进程在multiprocessing通信环节出现异常，进一步加剧了问题。

1. 在脚本中区分主进程与子进程，跳过子进程的参数解析 #

在脚本最开头添加判断逻辑，识别出undetected_chromedriver的子进程，直接跳过argparse解析和主逻辑执行：

import sys
import os
import multiprocessing

def main():
    # 主进程逻辑：参数解析+业务代码
    import argparse
    parser = argparse.ArgumentParser()
    parser.add_argument("-u", "--user", required=True)
    parser.add_argument("-p", "--password", required=True)
    args = parser.parse_args()
    
    # 后续业务逻辑，比如初始化undetected_chromedriver
    from undetected_chromedriver import Chrome
    driver = Chrome()
    # ...其他操作

if __name__ == "__main__":
    # 判断是否为multiprocessing子进程
    if multiprocessing.parent_process() is not None or os.environ.get("UCD_CHILD"):
        # 子进程，仅执行undetected_chromedriver所需逻辑，跳过主逻辑
        sys.argv = [sys.argv[0]]  # 清空参数避免argparse报错
        pass
    else:
        # 主进程，执行正常流程
        main()

2. 调整PyInstaller打包参数，确保依赖完整打包 #

打包时添加--collect-all参数，强制收集undetected_chromedriver的所有依赖文件，避免打包缺失导致的子进程异常：

py_installer_path\pyinstaller.exe --onefile --collect-all undetected_chromedriver c:\projects\proj1\main.py

3. 临时修改undetected_chromedriver的子进程启动逻辑 #

找到你的Python环境中undetected_chromedriver\dprocess.py文件，修改start_detached函数，确保子进程启动时不继承主进程的命令行参数：

# 替换subprocess.Popen调用部分：
subprocess.Popen(
    [sys.executable],  # 仅传递exe路径，不附加主进程参数
    stdin=subprocess.PIPE,
    stdout=subprocess.PIPE,
    stderr=subprocess.PIPE,
    creationflags=creationflags,
    close_fds=True,
)

注意：此方法属于临时补丁，更新undetected_chromedriver后需要重新修改。

4. 禁用undetected_chromedriver的分离进程模式 #

如果业务场景允许，初始化Chrome时设置detach=False，避免启动额外子进程：

from undetected_chromedriver import Chrome
driver = Chrome(detach=False)

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