jyfool的博客

本文记录了Wiki.js 3.x alpha版本在Ubuntu 24.04.3 LTS系统上通过Docker部署的过程及遇到的问题。部署流程包括Docker安装、环境初始化、Compose配置和服务启动等步骤，最终成功搭建测试环境（非生产）。然而在实施过程中遇到了包括GPG密钥验证失败、Docker镜像拉取超时、alpha版功能缺失等8个主要问题，其中部分问题通过配置调整解决，但Guest组权限等UI/数据库同步问题因alpha版不稳定未能完全修复。结论指出当前版本适合测试但不推荐生产使用，建议等待官方be

摘要： 本文记录了在Ubuntu环境中使用Python脚本批量导入Markdown页面到Wiki.js 2.5.308时遇到的GraphQL API 400错误排查过程。最初误用REST风格请求导致404，转用GraphQL后仍报400。通过分步验证发现核心问题：未满足GraphQL必填字段要求（如description、editor等非空字段）。最终通过硬编码完整mutation并打印原始响应(r.text)定位问题，成功实现批量导入。关键经验包括：优先使用GraphQL Playground测试、400