Docker部署Flink SQL Client设交互模式仍立即退出问题求助

核心问题现象 #

• 配置交互模式启动Flink SQL Client，容器启动后立即退出，日志显示SQL会话主动关闭
• 切换ENTRYPOINT脚本路径后容器能存活，但无法进入SQL Client交互终端，且无法访问Flink UI

问题根源分析 #

1. SQL Client启动命令参数错误 #

sql-client.sh中对-i参数的使用有误：Flink SQL Client的-i是指定初始化脚本路径，而非开启交互模式。交互模式是embedded模式的默认行为，但容器缺少终端支持时，交互程序会因无输入源直接退出。此外，脚本中注释位置错误，导致参数解析异常。

2. Entrypoint脚本路径不匹配 #

Dockerfile存在路径矛盾：将docker-entrypoint.sh复制到/opt/sql-client目录，却给/docker-entrypoint.sh添加执行权限，实际脚本路径与配置的ENTRYPOINT不一致，导致脚本无法正常执行。

3. 连接器库版本不兼容 #

下载的部分连接器（如flink-connector-jdbc:3.1.1-1.17、flink-json:1.17.1）与Flink 1.19.0版本不兼容，引发启动错误导致SQL Client会话直接关闭。

4. 容器缺少交互终端支持 #

Docker容器默认不分配伪终端（TTY），交互程序因无输入源会立即退出，导致SQL Client无法维持会话。

分步解决方案 #

1. 修正SQL Client启动脚本 #

修改sql-client.sh，移除错误参数，保留正确的embedded模式启动命令：

#!/bin/bash
${FLINK_HOME}/bin/sql-client.sh embedded -l ${SQL_CLIENT_HOME}/lib

2. 修复Entrypoint路径配置 #

调整Dockerfile，确保脚本复制路径、权限配置与ENTRYPOINT一致：

FROM flink:1.19.0-scala_2.12-java11

COPY sql-client.sh /opt/sql-client/

RUN mkdir -p /opt/sql-client/lib

# 下载兼容Flink 1.19.0的连接器库
RUN wget -P /opt/flink/lib/ https://repo.maven.apache.org/maven2/org/apache/flink/flink-sql-connector-kafka/1.19.0/flink-sql-connector-kafka-1.19.0.jar; \
    wget -P /opt/flink/lib/ https://repo.maven.apache.org/maven2/org/apache/flink/flink-sql-connector-kafka/3.2.0-1.19/flink-sql-connector-kafka-3.2.0-1.19.jar; \
    wget -P /opt/flink/lib/ https://repo.maven.apache.org/maven2/org/apache/flink/flink-connector-jdbc/3.2.0-1.19/flink-connector-jdbc-3.2.0-1.19.jar; \
    wget -P /opt/flink/lib/ https://repo.maven.apache.org/maven2/org/apache/flink/flink-json/1.19.0/flink-json-1.19.0.jar; \
    wget -P /opt/flink/lib/ https://jdbc.postgresql.org/download/postgresql-42.7.3.jar; \
    wget -P /opt/flink/lib/ https://repo.maven.apache.org/maven2/org/apache/flink/flink-sql-avro-confluent-registry/1.19.0/flink-sql-avro-confluent-registry-1.19.0.jar

WORKDIR /opt/sql-client
ENV SQL_CLIENT_HOME /opt/sql-client

COPY docker-entrypoint.sh /opt/sql-client/
RUN chmod +x /opt/sql-client/docker-entrypoint.sh

ENTRYPOINT ["/opt/sql-client/docker-entrypoint.sh"]

3. 配置容器交互终端 #

在docker-compose.yml的sql-client服务中添加终端支持配置，确保交互模式正常运行：

sql-client:
    container_name: sql-client
    build:
      context: .
      dockerfile: Dockerfile-sql
    depends_on:
      - jobmanager
    environment:
      - FLINK_JOBMANAGER_HOST=jobmanager
      - |
        FLINK_PROPERTIES=
        jobmanager.rpc.address: jobmanager
        rest.address: jobmanager
    networks:
     - datalou
    stdin_open: true  # 保持标准输入通道打开
    tty: true         # 分配伪终端支持交互

4. 验证服务启动与访问 #

1. 重新构建镜像：

   docker-compose build
   

2. 启动所有服务：

   docker-compose up -d
   

3. 进入SQL Client交互终端：

   docker exec -it sql-client /opt/sql-client/sql-client.sh
   

4. 访问Flink UI：直接打开浏览器访问http://localhost:8081（通过jobmanager的端口映射提供服务）

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