You need to enable JavaScript to run this app. Docker部署Quart应用时Hypercorn报Name does not resolve错误
优惠活动
大模型
产品
解决方案
定价
更多

Docker部署Quart应用时Hypercorn报Name does not resolve错误

异常根因

从报错栈可以看到,异常发生在Hypercorn初始化监听套接字的阶段,此时应用业务逻辑、数据库连接流程根本还未启动,和MySQL实例的连通性没有任何关系。
这个报错并非Docker容器网络跨域名解析问题,根源是Hypercorn监听绑定地址参数被错误传入了多余的单引号。
Dockerfile中的CMD采用exec数组格式启动程序,该格式不会经过Shell解释器处理单引号、转义符等语法,单引号会被作为参数值的一部分原样传递给Hypercorn。程序最终收到的绑定地址是带外围单引号的字符串'0.0.0.0:2020',在拆分host和port时,会把带前导引号的'0.0.0.0识别为主机名做DNS解析,自然抛出名称无法解析的错误。
本地运行正常的原因是:手动在Shell中敲命令时,Shell会自动剥离单引号,实际传给Hypercorn的是正常的0.0.0.0:2020地址,不会触发解析异常。

修复方案
  • 调整Dockerfile.pager中的CMD配置,去掉bind参数值外围多余的单引号:
    错误配置:
    CMD ["hypercorn", "pager:app", "--bind", "'0.0.0.0:2020'"]
    修正后的正确配置:
    CMD ["hypercorn", "pager:app", "--bind", "0.0.0.0:2020"]
  • 如果需要保留带单引号的写法,可将CMD改为Shell启动格式,由Shell负责解析单引号转义:
    CMD hypercorn pager:app --bind '0.0.0.0:2020'
网络配置验证提示

修正启动命令后重新构建pager镜像启动,即可正常完成端口绑定。当前docker-compose配置中,pager和master-db同属localdev桥接网络,pager连接MySQL时可直接使用服务名master-db作为主机、对应MySQL容器内部端口3306访问,无需使用宿主机映射的4000端口,不存在跨容器连通性障碍。

内容的提问来源于stack exchange,提问作者Swatcat

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 12:06:03