Python数组大小错误仅二进制发行版触发、源码运行正常如何排查？

你遇到的array is too big; arr.size * arr.dtype.itemsize is larger than the maximum possible size报错属于内存寻址上限限制问题，可按以下方向逐一排查：

• 排查可执行文件架构与运行环境架构一致性
  正常运行源码的Python环境大概率是64位版本，可首先确认打包生成的exe是否为32位版本：32位程序的最大寻址空间仅为4GB，实际可用用户内存通常不超过2GB，远远小于64位程序的寻址上限，加载大数组时必然触发报错。可以分别在源码运行环境和exe运行时执行import sys; print(sys.maxsize)对比输出值：32位版本输出为2147483647，64位版本输出为9223372036854775807。如果确认是32位exe问题，切换为64位Python环境重新打包即可解决。
• 排查打包依赖与运行源码依赖的一致性
  确认打包使用的Python环境与你正常运行源码的环境完全一致，重点核对numpy、tifffile、PIL等负责图像加载、数组运算的依赖库版本、架构是否匹配。打包工具自动收集依赖时可能误引入其他环境的32位版本依赖，或是阉割版的科学计算库，导致内存分配上限被限制。可在打包环境中先直接运行源码确认不会触发报错，再执行打包操作。
• 排查打包参数配置问题
  如果你使用的是PyInstaller一类的打包工具：
  1. 确认打包时没有添加内存限制类的自定义参数
  2. 优先尝试去掉--onefile参数打成分发目录版本运行，单文件打包模式需要将所有资源解压到临时目录运行，容易出现大内存分配失败的问题
  3. 确认打包时是否正确加载了numpy、scipy等科学计算库对应的官方hook，缺失hook可能导致库的内存分配功能异常
• 排查系统运行限制配置
  如果确认打包的是64位exe仍有问题，尝试以管理员身份运行exe，排除权限不足导致的内存分配限制；如果是32位exe且暂时无法切换64位环境打包，可以尝试开启大地址感知（LAA）配置，将32位程序的可用内存上限提升到3GB以上。

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