macOS下使用python-chess初始化Stockfish时遭遇TimeoutError求助

问题重现 #

在macOS上使用python-chess 1.10.0 + Python 3.9对接Stockfish时，执行初始化代码出现asyncio.exceptions.TimeoutError，同时伴随Secure coding警告和子进程监视器RuntimeWarning。

已尝试无效的操作 #

• 验证Stockfish路径正确
• 增加popen_uci超时时间
• 更新python-chess库
• 更新macOS和Python版本

可行解决方案 #

1. 替换为纯命令行版Stockfish #

Stockfish的.app安装包是带GUI的版本，启动时会输出额外的系统日志，干扰python-chess的UCI协议解析。建议从官方下载纯命令行版本，解压后将engine_path指向该可执行文件（比如./stockfish-macos-x86-64或对应架构的文件）。

2. 确保可执行权限 #

打开终端，给Stockfish可执行文件添加执行权限：

chmod +x /path/to/your/stockfish-executable

3. 强制命令行模式启动（针对.app版本） #

如果暂时不想替换版本，启动时添加--no-gui参数，禁用GUI组件：

import chess.engine

engine_path = '/Applications/Stockfish.app/Contents/MacOS/Stockfish'

if __name__ == '__main__':
    engine = chess.engine.SimpleEngine.popen_uci([engine_path, "--no-gui"])

4. 替换asyncio事件循环 #

Python 3.9默认的asyncio事件循环在macOS上处理子进程可能存在兼容性问题，使用uvloop替代：

1. 安装uvloop：

pip install uvloop

2. 在脚本开头添加：

import asyncio
import uvloop
asyncio.set_event_loop_policy(uvloop.EventLoopPolicy())

import chess.engine

engine_path = '/path/to/stockfish'

if __name__ == '__main__':
    engine = chess.engine.SimpleEngine.popen_uci(engine_path)

5. 显式异步等待引擎初始化 #

使用异步方式显式等待引擎发送uciok信号，避免超时：

import asyncio
import chess.engine

engine_path = '/path/to/stockfish'

async def main():
    # 设置更长超时时间，比如30秒
    transport, engine = await chess.engine.popen_uci(engine_path, timeout=30)
    await engine.uci()  # 显式等待初始化完成
    print("引擎初始化成功")
    # 后续操作...
    await engine.quit()

if __name__ == '__main__':
    asyncio.run(main())

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