pyinstaller打包报错： RecursionError: maximum recursion depth exceeded

最新推荐文章于 2025-06-10 17:23:01 发布
原创 最新推荐文章于 2025-06-10 17:23:01 发布 · 1.9w 阅读 · 56 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

今天给以前写的python脚本用pyinstaller打包的时候，居然报错了：

... 
 File "d:\programdata\anaconda3\lib\ast.py", line 253, in visit
    return visitor(node)
  File "d:\programdata\anaconda3\lib\ast.py", line 261, in generic_visit
    self.visit(item)
  File "d:\programdata\anaconda3\lib\ast.py", line 253, in visit
    return visitor(node)
  File "d:\programdata\anaconda3\lib\ast.py", line 263, in generic_visit
    self.visit(value)
  File "d:\programdata\anaconda3\lib\ast.py", line 253, in visit
    return visitor(node)
RecursionError: maximum recursion depth exceeded

看上去似乎是某个库自己递归遍历玩的太嗨了，超过了python的栈高度限制

搜索了一番，很快找到了解决办法： https://stackoverflow.com/questions/38977929/pyinstaller-creating-exe-runtimeerror-maximum-recursion-depth-exceeded-while-ca

 

在此总结下解

最低0.47元/天 解锁文章

200万优质内容无限畅学
成功解决RecursionError: maximum recursion depth exceeded
头部AI社区如有邀博主AI主题演讲请私信—心比天高，仗剑走天涯，保持热爱，奔赴向梦想！低调，专注，谦虚，自律，反思，成长，还算比较正能量的博主，公益免费传播…内心特别想在AI界做出一些可以推进历史进程影响力的技术(兴趣使然，有点小情怀，也有点使命感呀
02-20 6315
成功解决RecursionError: maximum recursion depth exceeded 目录 解决问题 解决思路 解决方法 解决问题 在程序pyinstaller打包的时候，遇到递归错误， RecursionError: maximum recursion depth exceeded 解决思路 递归错误：超过最大递归深度 解决方法 直接修改默认的最大递归深度即可！ 第一步，在py对应的spec文件内添加以下代码 ...
解决pyinstaller报错：RecursionError: maximum recursion depth exceeded while calling a Python object
FarryNiu的博客
08-06 2037
成功解决报错 pyinstaller -F xxx.py 报错后，找到当前目录下的xxx.spec，在此文件开头添加 import sys sys.setrecursionlimit(10000) 执行命令 pyinstaller -F xxx.spec
paddle在pyinstaller打包时候报错的解决办法
qq_43853961的博客
06-10 206
例如： “PyInstaller/loader/pyimod02_importers.py”,line 419,in exec_moduleFile "paddle/base/core.py"line 418，in File"paddle/base/core.py"line 410,in set paddle lib path Exception: sequence item 0: expected str instance, NoneType found。
解决使用pyinstaller打包报错： RecursionError: maximum recursion depth exceeded
一个小白的日常
07-10 3766
问题 今天使用pyinstaller把程序打包exe，出现了以下错误 File "d:\programdata\anaconda3\lib\ast.py", line 253, in visit return visitor(node) File "d:\programdata\anaconda3\lib\ast.py", line 261, in generic_visit ...
pyinstaller打包时出现RecursionError: maximum recursion depth exceeded的报错
程序星空实验室
02-19 656
问题： 有时候，我们执行pyinstaller -F xxx.py文件时，会遇到如下的错误提示： RecursionError: maximum recursion depth exceeded 说明某个库文件递归调用次数过多，超过了Python的最大栈高度的限制。 解决方案如下： 在生成的xxx.spec文件头部增加如下两行： import sys sys.setrecursionlimit(5000) 然后执行 pyinstaller xxx.spec 即可打包成功。 ...
pyinstaller 打包出现RecursionError: maximum recursion depth exceeded
追梦小狂魔的博客
01-13 214
路径下会生成 ".spec"文件，用记事本打开后在开始第一行输入 import sys sys.setrecursionlimit(5000) 然后再重新打包就行了 pyinstaller xxx.spec 注意是spec文件
pyinstaller 打包错误：RecursionError: maximum recursion depth exceeded
qq_17743307的博客
12-27 564
最近在用 pyinstaller 打包项目的时候遇到如下错误： RecursionError: maximum recursion depth exceeded 解决方案： 命令行下输入（我这里使用的收Anaconda Prompt） 执行 pyinstaller，会生成 filename.spec文件： pyinstaller -F filename.py 在 filename.spec...
pyinstaller:报错A RecursionError maximum recursion depth exceeded occurred.
weixin_44528491的博客
12-18 4308
pyinstaller:报错A RecursionError maximum recursion depth exceeded occurred.For working around please follow these instructions错误信息如下解决步骤1. 打开生成的 .spec 文件在表头输入以下代码2. 保存后，在cmd中运行 pyinstaller myprog.spec 错误信息如下 将cmd路劲改为main.py路径，使用pyinstaller -F mian.py 出现以下错误
pyinstaller打包报错： RecursionError: maximum recursion depth exceeded，UnicodeDecodeError
lak的专栏
07-16 2469
转载：https://blog.youkuaiyun.com/sinat_32651363/article/details/82841026 RecursionError 想使用python打包生成exe文件，突然发现在打包过程中会出现：RecursionError: maximum recursion depth exceeded异常，然而百度好久，都在说明一个问题：报错提示超过最大递归深度，解决办...
使用pyinstaller时出现RecursionError: maximum recursion depth exceeded问题的解决办法
CeasarD的博客
11-25 3711
在用 pyinstaller 打包项目的时候遇到如下错误： RecursionError: maximum recursion depth exceeded 解决方案： 1. 执行pyinstaller，会生成 filename.spec文件： pyinstaller -F -w -i manage.ico filename.py -F：打包为单文件 -w：Windows程序，不显示命...
使用pyinstaller 将python文件打包exe, A RecursionError (maximum recursion depth exceeded) occurred
victor_manches的博客
04-10 1567
今天需要把一个python文件转换成exe文件部署给其他人用，然后按照网上的方法用pyinstaller执行打包文件。然后，就遇到了深坑，按照作者给的方法改了test.spec 文件然后再去执行pyinstaller之后，还是没解决,国内百度一下告诉我的都跟作者说的一样，并没什么ruan用。去github上提问了，上面大神给出了一个建议，让我重新安装下环境，只放整个文件需要的包。。
关于pyinstaller打包exe时报错“A RecursionError (maximum recursion depth exceeded) occurred.”
MITA1的博客
03-29 851
关于pyinstaller打包exe时报错“A RecursionError (maximum recursion depth exceeded) occurred.”
(2020.1.2已解决)pyinstaller生成exe出错:RecursionError: maximum recursion depth exceeded
漫步量化
01-02 1331
问题描述 如题所述： ## 解决方案[^1] 采用`pyinstaller -F target.py`生成`exe`过程中，会生成一个`target.spec`文件，在此文件第二行加上如下两句： ```python import sys sys.setrecursionlimit(5000) # 设置递归深度 ``` 然后运行此文件： ```python pyinstaller...
pyinstaller打包报错： RecursionError: maximum recursion depth exceeded，UnicodeDecodeError 解决办法...
dengshubao1103的博客
09-05 411
出现原因： 这个错误意思是超过最大递归深度，python默认的递归深度默认是1000），因此当递归深度超过就会引发这样的异常。 解决方法： 1.执行pyinstaller -F XXX.py 它会在你的目录文件生成XXX.spec文件，然后报错，出现该类异常。 2.打开XXX.spec文件，在开头添加上面两行代码。 import sys sys.set...
python-用pyinstaller打包.py文件时，出现maxium recursion depth exceeded解决办法
RYOMARYOMA的博客
07-07 322
出现的问题如图： 解决办法： 在你要打包的.py文件路径下，会出现同名的.spec文件，用notepad打开该文件，在第二行添加上如下两句： import sys sys.setrecursionlimit(10000) 保存关闭该文件，然后在终端上输入： pyinstaller xxx.spec即可。我的是pyinstaller dataConvert_v1.2.spec。 就是用notepad打开图片中这个.spec文件： 然后在第二行添加上这两句话： 在终端上输入...
Python报错：RecursionError: maximum recursion depth exceeded in comparison
热门推荐
Kthemis的技术输出
06-28 7万+
错误 今天在用python写一个递归查询数据库的程序时，报了一个错误： RecursionError: maximum recursion depth exceeded in comparison 错误的大致意思就是递归超过了最大的深度。 原因 查询过相关文档和资料后才发现了问题原因，python的递归深度是有限制的，默认为1000。当递归深度超过1000时，就会报错。 解...
Python设置递归深度(python代码报错maximum recursion depth exceeded)
流柯软件测试
01-10 1121
Python写了一个递归脚本，运行报错：`python maximum recursion depth exceeded`
报错信息：RecursionError: maximum recursion depth exceeded while calling a Python object，但是看起来递归并没有达到1000次
最新发布
07-27
<think>我们正在讨论一个特殊场景：用户遇到了RecursionError，但实际递归深度并未达到1000次（默认限制）。这看起来违反直觉，但确实可能发生。以下我将分析可能原因并提供解决方案。 ### 原因分析 1. **多线程/异步环境中的递归限制** 在Python中，递归深度限制是**针对每个线程独立计算**的。如果程序使用多线程，每个线程的递归深度单独计数。但若主线程或其他线程同时进行深层递归，可能触发全局限制[^1][^2]。 2. **递归函数内调用其他递归函数** 递归函数A调用递归函数B时，两者的调用栈会叠加。例如： ```python def func_A(n): if n == 0: return func_B(n) # 调用另一个递归函数 def func_B(n): if n == 0: return func_A(n-1) # 互相调用 ``` 此时总递归深度为`func_A`和`func_B`的调用次数之和，即使单函数未超限，总和也可能超限[^3]。 3. **C扩展或内置函数递归** 部分C扩展模块（如NumPy、Pandas）或Python内置函数（如`__str__`、`__repr__`）可能隐式递归。例如： ```python class Node: def __init__(self, children): self.children = children def __repr__(self): return f"Node({self.children})" # 递归调用子节点的__repr__ # 循环引用导致无限递归 node = Node([]) node.children.append(node) print(node) # 触发RecursionError ``` 此类递归不直接可见，但会消耗栈深度[^4]。 4. **装饰器或元类导致的间接递归** 装饰器可能意外增加递归深度。例如： ```python def debug_decorator(func): def wrapper(*args): print("Calling", func.__name__) return func(*args) # 调用原函数 return wrapper @debug_decorator def recursive_func(n): if n == 0: return recursive_func(n-1) # 实际递归深度 = n + 装饰器调用次数 ``` 5. **系统栈空间不足** 操作系统对线程栈大小有限制（如Linux默认8MB）。即使递归次数较少，若单次调用占用栈过大（如大型局部变量），也可能提前触发栈溢出[^5]。 ### 解决方案 #### 1. 检查代码中的间接递归 - 排查是否存在函数间相互调用（如A→B→A）。 - 使用`sys._getframe().f_back`跟踪调用栈： ```python import sys def print_stack(depth=0): frame = sys._getframe() stack = [] while frame: stack.append(f"{frame.f_code.co_name}:{frame.f_lineno}") frame = frame.f_back print(f"Current depth: {len(stack)}") print("Stack trace:\n" + "\n".join(stack[-10:])) # 打印最后10层 ``` #### 2. 避免对象自引用 - 对包含循环引用的对象，重写`__repr__`或`__str__`方法： ```python class Node: def __init__(self, children): self.children = children def __repr__(self): return "Node(children)" # 避免递归输出子节点 ``` #### 3. 增加线程栈大小 - 对于多线程场景，可通过`threading.stack_size()`调整： ```python import threading threading.stack_size(1024*1024*32) # 32MB ``` 注意：必须在创建线程前设置。 #### 4. 使用迭代重写递归 将递归改为迭代（参考前文方法），这是最彻底的解决方案。 #### 5. 监控实际递归深度 在递归函数中添加计数器： ```python import sys def recursive_func(n, depth=0): if depth > 500: # 设置安全阈值 raise RuntimeError("Depth exceeds safe limit") # ...正常递归逻辑... recursive_func(n-1, depth+1) ``` ### 特殊情况：递归深度未达1000却报错 若递归深度明显小于1000仍报错，可能是： - **局部变量过大**：单个函数调用占用大量栈空间（如`local_var = [0]*1000000`）。 **解决**：减少栈占用，或用堆分配（如`global`或`heapq`）。 - **第三方库bug**：如旧版pyinstaller或tokenizer的已知问题[^4][^5]。 **解决**：更新库版本或应用补丁。 ### 总结流程 ```mermaid graph TD A[出现RecursionError但递归深度<1000] --> B{检查原因} B --> C1[多线程/异步环境] B --> C2[函数间递归调用] B --> C3[隐式递归（如__repr__）] B --> C4[局部变量过大] B --> C5[第三方库问题] C1 --> D1[增加线程栈大小] C2 --> D2[改为迭代或消除交叉递归] C3 --> D3[重写特殊方法] C4 --> D4[减少栈占用] C5 --> D5[更新库版本] ``` 通过以上方法，您可定位并解决非常规递归深度问题。若仍无法解决，建议提供最小可复现代码以便进一步分析。 §§相关问题§§ 1. 如何检测Python程序中的循环引用？ 2. 在多线程环境中如何安全地使用递归？ 3. 如何计算Python函数的栈空间占用？ 4. 哪些Python内置函数可能导致隐式递归？ 5. 如何为包含递归的Python程序设置线程栈大小？ [^1]: 引用自：RecursionError: maximum recursion depth exceeded原因及解决办法。 [^2]: 引用自：【Python】解决Python报错：RecursionError: maximum recursion depth exceeded。 [^3]: 引用自：Python报错：RecursionError: maximum recursion depth exceeded。 [^4]: 引用自：tokenizer出现RecursionError: maximum recursion depth exceeded while getting the str of an object的解决方案。 [^5]: 引用自：Python：pyinstaller报错【A RecursionError maximum recursion depth exceeded occurred】。</think>### Python RecursionError 但递归深度未达1000的原因与解决方案 当出现 `RecursionError: maximum recursion depth exceeded` 但实际递归调用次数未达到默认1000次限制时，通常有以下特殊原因及解决方案： --- #### 一、常见原因分析 1. **隐式递归调用** - 对象方法（如 `__str__`, `__repr__`, `__getattr__`）被意外递归调用 - **示例**： ```python class Node: def __init__(self, value): self.value = value self.children = [] def __repr__(self): # 错误：递归调用子节点的__repr__ return f"Node({self.value}, {self.children})" root = Node(1) child = Node(2) root.children.append(child) child.children.append(root) # 循环引用 print(root) # 触发RecursionError ``` *引用自对象循环引用场景[^4]* 2. **装饰器叠加递归** - 多层装饰器导致实际调用深度倍增 - **示例**： ```python def debug_decorator(func): def wrapper(*args): print(f"Calling {func.__name__}") return func(*args) # 装饰器本身增加调用深度 return wrapper @debug_decorator def recursive_func(n): if n <= 0: return recursive_func(n-1) # 实际深度 = n * 装饰器层数 ``` 3. **第三方库内部递归** - 使用库（如NLTK、SpaCy）时，其内部实现存在递归调用 - 典型场景：复杂文本解析、语法树生成[^4] 4. **系统栈空间不足** - 单次递归调用占用过大栈空间（如大型局部变量） - 递归深度远小于1000时即触发系统级栈溢出 5. **元类/metaclass 递归** - 元类中的 `__new__` 或 `__prepare__` 方法意外递归 --- #### 二、针对性解决方案 ##### 1. 对象循环引用问题 ```python class Node: def __init__(self, value): self.value = value self.children = [] def __repr__(self): # 安全方案：限制递归深度 return f"Node({self.value}, children_count={len(self.children)})" ``` ##### 2. 装饰器深度优化 ```python import functools def debug_decorator(func): @functools.wraps(func) def wrapper(*args): # 添加深度监控 if wrapper.depth > 100: raise RuntimeError("Depth limit reached") wrapper.depth += 1 result = func(*args) wrapper.depth -= 1 return result wrapper.depth = 0 return wrapper ``` ##### 3. 第三方库问题处理 - **步骤**： 1. 更新库到最新版本 2. 限制输入规模（如缩短文本长度） 3. 替换为迭代型工具（如SpaCy的`nlp.pipe`替代逐句处理） ##### 4. 栈空间优化 ```python def recursive_func(n, large_data=None): # 将大型数据移出栈帧 large_data = large_data or [] # 使用生成器减少内存占用 if n <= 0: yield else: yield from recursive_func(n-1, large_data) ``` ##### 5. 元类递归预防 ```python class SafeMeta(type): def __new__(cls, name, bases, dct): # 避免在__new__中创建同类实例 if not hasattr(cls, '_creating'): cls._creating = True instance = super().__new__(cls, name, bases, dct) delattr(cls, '_creating') return instance else: raise RuntimeError("Recursive metaclass call") ``` --- #### 三、调试工具与方法 1. **调用栈分析** ```python import sys import traceback def recursive_func(n): if n % 50 == 0: # 每50层打印栈信息 traceback.print_stack(limit=5) # ...递归逻辑... ``` 2. **深度监控装饰器** ```python def depth_monitor(func): def wrapper(*args, **kwargs): wrapper.count += 1 if wrapper.count > 500: raise RuntimeError(f"Depth exceeded at {wrapper.count}") result = func(*args, **kwargs) wrapper.count -= 1 return result wrapper.count = 0 return wrapper ``` 3. **内存分析工具** ```bash pip install memory-profiler mprof run --include-children your_script.py ``` --- #### 四、根本性预防策略 | **方案** | **适用场景** | **优势** | |-----------------------|----------------------------|-----------------------------| | 迭代替代递归 | 算法可改写 | 彻底避免递归限制 | | 尾递归优化 | 函数式编程场景 | 减少栈空间占用 | | 显式栈管理 | 复杂递归逻辑 | 完全控制调用深度 | | 分治+循环 | 大数据处理 | 并行处理能力 | > **关键提示**：当递归深度异常时，优先检查是否有**间接递归**（如通过属性访问触发的方法调用）而非直接递归调用[^4]。
评论 16
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值