向列表添加对象时触发ValueError: Circular reference detected的原因

在Replit中编程时，尝试将自定义Lemon对象加入列表，创建新游戏并将数据更新为默认数据时，程序抛出ValueError: Circular reference detected错误，该错误仅在向列表添加对象时出现。

相关代码 #

Lemon类定义 #

class Lemon:
  def __init__(self, _type, _rating):
    self.type = _type
    self.rating = _rating

  def typeText(self):
    # basic lemons
    if self.type == 0:
      return 'Basic lemon'
    elif self.type == 1:
      return 'Happy lemon'
    elif self.type == 2:
      return 'Sad lemon'
    elif self.type == 3:
      return 'Hasty lemon'
    elif self.type == 4:
      return 'Cool lemon'
    # rare lemons
    elif self.type == 5:
      return '[gold3]Fire lemon[/gold3]'
    elif self.type == 6:
      return '[gold3]Ice lemon[/gold3]'
    elif self.type == 7:
      return '[gold3]Tired lemon[/gold3]'
    elif self.type == 8:
      return '[gold3]Shocked lemon[/gold3]'
    elif self.type == 9:
      return '[gold3]Bored lemon[/gold3]'
    # epic lemons
    elif self.type == 10:
      return '[green]Caveman lemon[/green]'
    elif self.type == 11:
      return '[green]Future lemon[/green]'
    elif self.type == 12:
      return '[green]Alien lemon[/green]'
    elif self.type == 13:
      return '[green]Liquid lemon[/green]'
    # legendary lemons
    elif self.type == 14:
      return '[cyan]Cat lemon[/cyan]'
    elif self.type == 15:
      return '[cyan]Dog lemon[/cyan]'
    elif self.type == 16:
      return '[cyan]Earth lemon[/cyan]'
    # mythic lemons
    elif self.type == 17:
      return '[blue]Water lemon[/blue]'
    elif self.type == 18:
      return '[blue]Air lemon[/blue]'
    # magical lemons
    elif self.type == 19:
      return '[magenta]Elemental lemon[/magenta]'
  def show(self, bare=True):
    if bare:
      return self.typeText()
    else:
      return f'{self.typeText()} with a rating of {self.rating}'

默认数据定义 #

defaultData = {'money': 0,
              'lemons': [Lemon(1, 1)]}

错误原因分析 #

这个错误几乎都是**序列化操作（比如存储数据到文件/Replit内置存储）**导致的：

• 你在defaultData中直接实例化了Lemon对象，但绝大多数序列化工具（包括Replit的存储模块、Python标准库的json模块）无法直接处理自定义类的实例。当工具尝试遍历对象属性进行序列化时，要么无法识别对象类型，要么在后续代码的隐性逻辑中（比如赋值操作）让Lemon对象间接引用了包含它的列表，从而触发循环引用检测。
• 从给出的Lemon类代码看，__init__方法只初始化了简单的数值属性，本身不存在循环引用，核心问题是直接将自定义类实例存入了需要序列化的默认数据结构中。

解决建议 #

• 不要在默认数据中存储Lemon实例，改用可序列化的原始数据（比如字典）保存对象参数：

  defaultData = {'money': 0,
                'lemons': [{'type': 1, 'rating': 1}]}
  

• 当需要使用Lemon对象时，通过原始数据重建实例：

  lemons_list = [Lemon(item['type'], item['rating']) for item in defaultData['lemons']]
  

• 如果使用Replit的db模块存储数据，确保只存入字符串、数字、列表、字典这类基础可序列化类型，避免直接存储自定义类实例。

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