使用python-chess开发国际象棋引擎遇AssertionError错误求助

1. san()函数断言错误的原因 #

报错信息里的FEN字符串末尾是b，代表当前是黑方回合，但你传入san()的走法是b2b3——这是白方兵的移动，不属于当前黑方回合的合法走法。python-chess的san()方法要求传入的走法必须是当前棋盘局面下的合法走法（或空着法），所以触发了断言错误。

2. getMoves函数FEN异常的排查方向 #

你提到调用getMoves后，打印棋盘显示正常但FEN是推进入走法后的局面，问题大概率出在evalBoard函数里：

• 如果evalBoard内部对传入的board对象执行了push操作，但没有对应的pop来恢复状态，就会导致原board的局面被永久修改。虽然getMoves里每次push后都pop了，但evalBoard里的未恢复操作会叠加改变board状态。
• 比如evalBoard里做深度搜索时，push了多步走法但没全部pop，最后board的局面就会停留在搜索后的状态，而非初始状态。

解决步骤 #

针对san()错误 #

• 确保调用BOARD.san(move)时，move是当前BOARD局面的合法走法。比如白方回合生成的走法，只能在白方回合使用；黑方回合要使用黑方的合法走法。
• 检查你获取whiteMove的逻辑，确认它是在白方回合从board.legal_moves中生成的，且调用san()时BOARD仍处于白方回合。

针对FEN异常 #

• 修复evalBoard函数：
  1. 所有在evalBoard中对board的push操作，必须配对执行pop，确保函数结束时board状态和传入时一致。
  2. 更稳妥的方式是在evalBoard中操作棋盘的副本，而非原对象：

     def evalBoard(board: Board):
         temp_board = board.copy()  # 创建副本，不影响原棋盘
         # 在这里操作temp_board，比如push、评估等
         # ...
         return evaluation_result
     

• 可以在getMoves函数的循环前后分别打印FEN，验证每一次push+pop后棋盘是否恢复：

  def getMoves(board: Board):
      initial_fen = board.fen()
      legalMoves = [move for move in board.legal_moves]
      evals = {}
      for move in legalMoves:
          board.push(move)
          moveEval = evalBoard(board)
          evals.update({move: moveEval})
          board.pop()
          # 每次循环后检查是否和初始FEN一致
          assert board.fen() == initial_fen, f"棋盘状态未恢复，当前FEN: {board.fen()}"
      print(board.fen())
      return evals
  

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