Docker镜像正常运行时调用API返回400 Bad Request错误如何解决？

1. 验证请求合法性 #

• 确认请求路径完全匹配服务端定义：容器端口映射为5001到内部80，注意API前缀不能漏写，路径大小写要和服务端要求一致
• 检查请求方法是否匹配：比如服务端要求POST的接口用GET请求就会触发400
• 校验请求参数/请求体格式：
  • GET请求检查URL参数是否有未转义的特殊字符，必填参数是否缺失
  • POST/PUT等带请求体的请求，确认Content-Type头和请求体格式匹配，比如传JSON需要带Content-Type: application/json头，同时JSON本身无语法错误
  • 所有必填参数的类型、取值范围符合服务端要求，比如数字类型参数不能传入字符串格式

2. 检查容器内服务状态 #

• 执行docker logs [容器ID/容器名]查看服务日志，大部分框架会将400的具体触发原因打印在日志中，同时确认服务是否真的完成启动、无初始化报错
• 进入容器内部本地测试接口：执行docker exec -it [容器ID/容器名] /bin/bash（alpine镜像替换为/bin/sh），在容器内用curl直接调用127.0.0.1:80的对应接口，如果容器内调用也返回400，说明问题出在服务本身配置，和端口映射、外部网络无关
• 确认服务监听地址：排查服务是否监听在0.0.0.0:80而非仅127.0.0.1:80

3. 排查网络/中间层配置 #

• 确认调用地址正确：本机调用用http://127.0.0.1:5001，跨机器调用要确认宿主机5001端口的防火墙、安全组规则已放开
• 检查是否有反向代理、Nginx等中间层篡改请求：确认代理不会修改请求头、请求路径，不会错误设置Host头导致服务端校验不通过
• 校验请求大小是否超出服务端限制：多数服务会设置最大请求体阈值，上传大文件或传参过大会触发400错误

4. 特殊场景排查 #

• 检查挂载卷权限：你配置了backend-files:/Files挂载，确认服务对该目录有对应读写权限，权限不足可能导致请求处理时返回400
• 确认镜像启动的必要配置无缺失：有没有漏传服务需要的环境变量，比如数据库地址、API前缀配置等，配置缺失会导致服务逻辑异常返回400

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