PyInstaller打包图形EXE后pyogrio write_Dataframe无法写入SHP问题

问题复现特征 #

• 基于Python开发的Excel转Shapefile工具，在PyCharm等开发环境中运行时全功能正常
• 使用PyInstaller编译为console=False的无控制台GUI程序后，界面交互完全正常，但调用pyogrio.write_dataframe()时不会生成目标Shapefile文件，也无任何错误提示
• 当前已配置的pyogrio相关隐藏导入为：['pyogrio._err', 'pyogrio._geometry', 'pyogrio.errors', 'pyogrio._io', 'pyogrio._ogr']
• 核心调用代码：

write_dataframe(geotable, path, encoding='utf-8')

• 当前使用的PyInstaller spec配置未配置binaries、datas项，开启了UPX压缩。

核心成因 #

1. 原生依赖与资源文件缺失：pyogrio是GDAL/OGR的轻量Python绑定，运行时除了自身Python模块，还依赖GDAL原生动态链接库、驱动配置文件、投影参数数据库等非Python资源。当前spec配置中binaries、datas为空，这些资源完全没有被打包进EXE。无控制台模式下程序的stdout、stderr被系统重定向到空设备，GDAL驱动加载失败、初始化报错的信息完全不会外显，表现为静默失败。
2. 隐藏导入配置不全：现有hiddenimports列表遗漏了pyogrio的核心子模块（IO工具、CRS处理、兼容层模块），以及pyogrio强依赖的osgeo（GDAL Python绑定）、pyproj、shapely相关模块，触发ImportError时同样因为无控制台被静默吞掉。
3. UPX压缩损坏原生库：当前配置开启了upx=True，UPX压缩GDAL这类带多层资源段、重定位表的原生dll时，大概率会导致dll加载失败，这类加载错误在无控制台模式下也不会弹出提示。
4. 权限问题基本可以排除：如果是目标目录写入权限不足，开发环境下写入同一路径时同样会触发报错，且pyogrio会直接抛出权限类异常，不会出现静默无输出的情况。

分步解决方案 #

1. 优先开启控制台模式定位真实报错 #

将spec文件中EXE段的console=False临时修改为console=True，重新打包后运行EXE复现操作，控制台会直接打印真实报错信息（缺dll、缺模块、路径错误等），这是效率最高的排查手段，不要在无控制台模式下盲猜问题。

2. 补全隐藏导入列表 #

将spec中Analysis段的hiddenimports替换为如下完整配置：

hiddenimports=[
    'pyogrio._err',
    'pyogrio._geometry',
    'pyogrio.errors',
    'pyogrio._io',
    'pyogrio._ogr',
    'pyogrio._io.util',
    'pyogrio._crs',
    'pyogrio.geopandas_compat',
    'pyogrio._env',
    'osgeo',
    'osgeo.ogr',
    'osgeo.osr',
    'osgeo.gdal',
    'pyproj',
    'shapely'
],

3. 关闭UPX压缩排除二进制损坏问题 #

将spec中EXE段的upx=True修改为upx=False，避免UPX压缩破坏GDAL、GEOS等原生库的文件结构，后续确认功能正常后如果需要压缩体积，再将GDAL相关dll加入upx_exclude列表后尝试开启。

4. 自动收集原生依赖与资源文件 #

不要手动复制dll和数据文件，直接用PyInstaller自带的钩子工具自动收集pyogrio、GDAL运行所需的所有二进制文件和资源，避免漏文件。
在spec文件最开头添加如下导入与收集逻辑：

# -*- mode: python ; coding: utf-8 -*-
import pyogrio
from PyInstaller.utils.hooks import collect_dynamic_libs, collect_data_files

# 自动收集pyogrio、GDAL相关的原生动态链接库
binaries = collect_dynamic_libs('pyogrio') + collect_dynamic_libs('osgeo')
# 自动收集GDAL驱动配置、投影数据库、pyogrio内置资源
datas = collect_data_files('pyogrio') + collect_data_files('osgeo')

block_cipher = None

然后修改Analysis段的对应配置，把空的binaries、datas替换为上面收集到的内容：

a = Analysis(
    ['EXCEL2SHP.py'],
    pathex=[],
    binaries=binaries,
    datas=datas,
    hiddenimports=[...], # 用前面补全后的列表
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[],
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=block_cipher,
    noarchive=False,
)

其余PYZ、EXE段的原有配置（除upx、console项外）保持不变即可。

5. 路径与异常兜底配置 #

• 调用write_dataframe时传入的输出路径必须是绝对路径：PyInstaller打包的无控制台程序运行时工作目录可能和预期不一致，相对路径会导致文件写入到未知位置，表现为“找不到生成的文件”。
• 给写入逻辑加异常捕获，通过GUI弹窗展示错误，不要依赖控制台输出：

import traceback
try:
    write_dataframe(geotable, target_abs_path, encoding='utf-8')
    # 此处添加写入成功的GUI提示
except Exception as e:
    err_info = f"Shapefile写入失败：{str(e)}\n\n详细报错：\n{traceback.format_exc()}"
    # 调用自身GUI框架的弹窗组件展示err_info，比如tkinter的messagebox.showerror

验证流程 #

1. 按上述步骤修改完spec配置后，保持console=True重新打包
2. 运行EXE测试转换功能，如果控制台无报错且能在目标路径生成完整的SHP文件（.shp/.shx/.dbf/.prj四个核心文件），再将console改回False重新打包即可
3. 如果仍有异常，根据控制台打印的报错信息补全对应缺失的依赖即可。

内容的提问来源于stack exchange，提问作者The Bavarian Wolf