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
相关产品推荐
相关产品推荐

