通过FastAPI触发时无法连接Docker容器内的Sybase数据库

问题背景 #

本地直接启动uvicorn服务器（命令：uvicorn api:app --host 0.0.0.0 --port 5001 --reload）时，API的fetch_data端点可正常执行Sybase查询并返回数据。但将uvicorn和Kafka打包进Docker容器运行（映射5001端口）后，出现以下异常：

• 容器内Kafka消息触发的SQL查询可正常返回数据，证明应用能连接数据库
• API调用触发查询时，卡在connection = DriverManager.getConnection(connection_url, user, password)行无限阻塞，无报错
• API的Swagger页面可正常访问，uvicorn服务器运行正常

排查与解决方案 #

1. 验证API与Kafka的连接配置一致性 #

同一容器内Kafka能连数据库，说明数据库地址、账号密码本身没问题，但需确认API请求线程和Kafka消费线程使用的是完全相同的连接参数：

• 在代码中分别打印API触发、Kafka触发时的connection_url、user、password参数，对比是否存在差异（例如API加载了错误的配置文件、环境变量读取不一致）
• 确保connection_url中数据库地址不是localhost（容器内localhost指向自身，若数据库不在容器内会失败，但Kafka能连所以大概率不是，但仍需确认）

2. 添加连接超时参数，定位阻塞原因 #

默认DriverManager.getConnection无超时设置，会无限阻塞，添加超时参数可强制抛出异常，明确问题类型：

• 根据Sybase JDBC驱动版本，在connection_url中添加超时配置，例如：

  String connection_url = "jdbc:sybase:Tds:<db-host>:<db-port>/<db-name>?loginTimeout=15";
  

• 运行后若抛出超时异常，可进一步排查网络连通性；若抛出权限/不存在异常，需检查参数正确性

3. 排查连接池与线程资源占用 #

若Kafka消费线程占用了所有数据库连接，会导致API请求线程无法获取连接而阻塞：

• 检查数据库连接池配置（如最大连接数maxConnections），确认Kafka消费线程未长期持有连接不释放
• 登录Sybase数据库，执行查询查看当前连接数与连接来源：

  sp_who
  

  确认是否有大量连接被Kafka线程占用

4. 检查Sybase驱动的线程安全性 #

部分旧版本Sybase JDBC驱动存在线程安全问题，多线程（API请求线程+Kafka消费线程）并发调用时可能出现异常：

• 更换为最新稳定版的Sybase JDBC驱动（如jConnect 16.0及以上版本）
• 确保驱动jar包在Docker容器内正确加载，未出现版本冲突

5. 验证容器内网络与DNS解析 #

虽然Kafka能连，但API请求线程的网络解析可能存在差异：

• 在Docker容器内执行命令，手动测试数据库连通性：

  # 测试端口连通性
  telnet <db-host> <db-port>
  # 测试DNS解析
  nslookup <db-host>
  

• 在API代码中添加日志，打印数据库地址的DNS解析结果，与Kafka线程的解析结果对比

6. 检查容器环境变量差异 #

确认Docker容器内的环境变量与本地非Docker环境一致：

• 检查是否存在http_proxy、https_proxy等代理变量，可能影响API请求的数据库连接（Kafka消费线程可能未使用代理）
• 确保容器内的时区、编码等环境变量与数据库匹配，避免隐性连接问题

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