Skip to content

TROUBLESHOOTING.md

Latest commit

 

History

History
206 lines (140 loc) · 4.05 KB

TROUBLESHOOTING.md

File metadata and controls

206 lines (140 loc) · 4.05 KB

故障排查指南

本文档提供 AutoCode MCP Server 的常见问题和解决方案。

编译问题

C++ 编译器未找到

错误信息：

Compiler not found: g++
Compilation failed with error

解决方案：

  1. Windows 平台：

  2. Linux/macOS：

    • 安装 g++：sudo apt install g++ 或 brew install gcc

  3. 验证安装：

    g++ --version

C++2c 标准不支持

错误信息：

error: 'c++2c' is not a valid standard

解决方案：

  1. 升级到 GCC 14+：

    gcc --version  # 需要 14.0 或更高

  2. 或降级到 C++20：

    • 修改 compiler.py 中的 std 参数默认值

编译超时

错误信息：

Compilation timeout after 30s

解决方案：

  1. 检查代码复杂度，可能有模板递归展开
  2. 增加 compile_cpp() 的 timeout 参数
  3. 检查是否有头文件循环依赖

执行问题

二进制文件未找到

错误信息：

Binary not found: /path/to/binary

解决方案：

  1. 确保已运行 *_build 工具
  2. 检查文件扩展名：
    • Windows：需要 .exe
    • Linux/macOS：无扩展名
  3. 验证编译是否成功（检查 compile_result.success）

执行超时 (TLE)

错误信息：

Execution timeout after 30s

解决方案：

  1. 增加超时时间
  2. 优化算法复杂度
  3. 检查是否有死循环或低效代码

内存限制错误（仅 Linux）

错误信息：

Binary not found or prlimit unavailable

解决方案：

  1. 安装 prlimit： 
    sudo apt install util-linux
  2. Windows 平台内存限制不支持，仅依赖超时控制

测试问题

stress_test 失败

可能原因：

  1. Generator 失败：检查 gen.cpp 生成逻辑
  2. sol 失败：检查 sol.cpp 代码正确性
  3. brute 失败：检查 brute.cpp 代码正确性
  4. Validator 失败：检查 val.cpp 验证逻辑

调试步骤：

  1. 运行单轮测试（设置 trials=1）
  2. 检查失败的输入数据
  3. 比较 sol 和 brute 的输出差异

Validator 验证不一致

症状：

  • 预期 expected_valid=True，但实际返回非零退出码
  • 或相反情况

解决方案：

  1. 检查 Validator 使用 quitf(_ok, ...) 或 quitf(_wa, ...)
  2. 确保退出码正确：
    • _ok → exit 0
    • _wa 或其他 → exit 非 0

平台特定问题

Windows 路径问题

症状：

OSError: [WinError 32] The process cannot access the file

解决方案：

  1. 确保路径使用正斜杠 / 或双反斜杠 \\
  2. 避免使用保留名称（如 con, prn, aux）
  3. 检查文件是否被其他进程占用

Windows 文件权限问题

错误信息：

PermissionError: [Errno 13] Permission denied

解决方案：

  1. 关闭可能占用文件的程序
  2. 以管理员身份运行
  3. 检查文件是否设置为只读

性能优化

测试生成缓慢

优化建议：

  1. 使用 test_count 参数限制测试数量
  2. 调整 max_attempts 系数（默认 test_count * 10）
  3. 优化 gen.cpp 生成算法复杂度

对拍测试缓慢

优化建议：

  1. 减小 n_max 参数（默认 100）
  2. 减少 trials 轮数
  3. 优化 brute.cpp 暴力解法复杂度

MCP Server 问题

无法连接 Server

检查清单：

  1. 确认 autocode-mcp 命令可执行
  2. 检查 MCP 客户端配置
  3. 验证 Python 虚拟环境已激活

工具调用失败

调试步骤：

  1. 查看 Server 日志的完整错误信息
  2. 验证 input_schema 参数是否正确
  3. 检查 problem_dir 路径是否存在且有写权限

获取帮助

如果遇到未在本文档中列出的问题：

  1. 查看测试用例：tests/ 目录
  2. 检查工具文档：src/autocode_mcp/tools/ 源代码注释
  3. 运行测试验证环境：pytest tests/ -v
  4. 提交 Issue：GitHub Issues