Python3.7升级3.12后PyInstaller编译程序崩溃，PyCharm可正常运行

1. 定位AttributeError: 'NoneType' object has no attribute 'write'根源 #

这个错误核心是代码尝试调用一个None对象的write方法，常见触发场景及排查方式：

• 标准输出/错误流重定向问题：如果代码自定义了sys.stdout或sys.stderr的重定向逻辑，打包后运行环境可能未正确初始化这两个对象，导致其变为None。
• 文件操作异常处理不当：代码中打开文件时若捕获错误后将文件对象设为None，后续调用write就会触发错误（Python3中open()失败默认抛FileNotFoundError，但自定义异常处理可能导致此问题）。
• 第三方库兼容性问题：高版本Python中，部分旧库的内部文件操作逻辑可能返回None。

具体排查操作： #

• 带调试参数重新打包，捕获完整报错栈：

  pyinstaller --debug=all your_script.py
  

  运行打包后的程序，会输出详细调用栈，直接定位触发错误的代码行。
• 在代码关键位置添加本地日志：

  import logging
  import sys
  logging.basicConfig(filename='run_debug.log', level=logging.DEBUG)
  
  # 若怀疑是标准输出问题
  logging.debug(f"sys.stdout status: {sys.stdout}")
  # 若怀疑文件操作问题，在open()后添加
  file_obj = open("test.txt", "w")
  logging.debug(f"File object status: {file_obj}")
  

  打包运行后查看run_debug.log，确认哪个对象变为None。

2. 修复Python 3.7→3.12的兼容性问题 #

从3.7到3.12有大量语法、函数的弃用与行为变更，重点检查以下内容：

• 第三方库版本适配：执行pip list列出所有依赖库，确认每个库是否支持Python3.12，将不兼容的库升级到最新稳定版（比如旧版pymysql、requests可能存在兼容性问题）。
• 弃用语法/函数替换：
  • collections模块中旧类（如collections.MutableMapping）在3.10+被移除，需替换为collections.abc下的对应类；
  • urllib模块的旧函数（如urllib.urlencode）需替换为urllib.parse.urlencode；
  • 若代码用到asyncio，需检查API行为变化（如loop.run_until_complete在3.10+的弃用提示）。
• 文件路径规范化：PyInstaller打包后会创建临时资源目录，旧代码的相对路径可能失效。统一使用绝对路径或通过sys._MEIPASS获取打包后的资源路径：

  import sys
  import os
  
  def get_absolute_path(relative_path):
      try:
          # PyInstaller打包后的临时资源目录
          base_path = sys._MEIPASS
      except Exception:
          # 开发环境下的当前目录
          base_path = os.path.abspath(".")
      return os.path.join(base_path, relative_path)
  

  所有文件读写操作均使用此函数获取路径。

3. 解决PyCharm运行时数据库超时问题 #

PyCharm能启动但数据库超时，大概率是环境或驱动问题：

• 网络/权限校验：检查打包后程序的运行权限（比如是否被防火墙拦截）、数据库服务器白名单是否允许当前机器访问。
• 数据库驱动升级：Python3.12对旧版数据库驱动（如psycopg2-binary、pymysql）兼容性差，升级驱动到支持3.12的版本。
• 连接参数调整：高版本Python对SSL、连接超时的默认配置有变化，比如pymysql需显式设置ssl=None或调整connect_timeout参数，确保连接参数符合新版本驱动要求。

4. 优化PyInstaller打包配置 #

新版本PyInstaller默认使用onedir模式（生成_internal文件夹），若需要旧版同目录结构，可改用--onefile参数打包：

pyinstaller --onefile your_script.py

同时确保PyInstaller为最新版本，旧版对Python3.12支持不足：

pip install --upgrade pyinstaller

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