Ariadne-GraphQL依赖兼容报错，如何解决ModuleNotFoundError等问题？

问题根源 #

你遇到的两个错误本质是Ariadne版本与graphql-core版本不匹配：

• 新版Ariadne（0.17+）移除了PLAYGROUND_HTML，你因此降级graphql-core到<3.1，但新版Ariadne依赖graphql-core 3.1+，导致找不到graphql.pyutils.undefined模块。
• 旧版Ariadne（0.16.x及更早）保留PLAYGROUND_HTML，且兼容graphql-core 3.0.x~3.1.x。

方案一：继续使用PLAYGROUND_HTML（回退到兼容版本） #

• 卸载当前Ariadne和graphql-core：

  pip uninstall -y ariadne graphql-core
  

• 安装指定版本的Ariadne（0.16.x是最后保留PLAYGROUND_HTML的系列）和匹配的graphql-core：

  pip install "ariadne==0.16.0" "graphql-core>=3.0,<3.2"
  

• 验证导入：

  from ariadne.constants import PLAYGROUND_HTML
  from ariadne import load_schema_from_path, make_executable_schema, graphql_sync, snake_case_fallback_resolvers, ObjectType
  

方案二：使用新版Ariadne（放弃PLAYGROUND_HTML，改用官方推荐方式） #

• 卸载当前版本，安装最新版Ariadne和对应兼容的graphql-core：

  pip uninstall -y ariadne graphql-core
  pip install ariadne
  

• 替换PLAYGROUND_HTML的使用：新版Ariadne提供playground()函数生成Playground页面，示例用法：

  from ariadne import playground, graphql_sync, ...
  
  # 在视图中返回Playground页面
  def graphql_playground(request):
      return HttpResponse(playground(), content_type='text/html')
  

• 验证核心模块导入：

  from ariadne import load_schema_from_path, make_executable_schema, graphql_sync, snake_case_fallback_resolvers, ObjectType
  

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