Python subprocess.run捕获psql输出在K8s Pod中挂起问题

在终端执行subprocess.run调用kubectl exec获取Postgres数据库列表时正常，但添加capture_output=True后命令挂起，查看Pod进程发现psql关联了pager进程，处于等待输入状态。

问题原因 #

问题出在kubectl exec的-it参数上。-it是-i（保持标准输入打开）和-t（分配伪终端TTY）的组合，专为交互式终端场景设计。当使用capture_output=True捕获输出时，没有真实的交互式终端，psql会自动触发分页器（如less），导致进程卡住等待用户输入。

解决方案 #

1. 移除-it参数（推荐） #

捕获输出不需要交互式终端，直接移除-it即可解决挂起问题：

result = subprocess.run(
    [
        'kubectl', '--context', 'my-context', '-n', 'mynamespace',
        'exec', 'postgres-helper-58dc64d7f4-cmkxl', '--',
        '/bin/bash', '-c', 'psql postgresql://postgres:password@postgres-postgresql --list --quiet --tuples-only'
    ],
    check=True,
    capture_output=True
)

2. 强制禁用psql分页器 #

若因特殊需求无法移除-it，可通过以下两种方式禁用psql的分页机制：

• 方式1：设置PAGER=cat环境变量

  result = subprocess.run(
      [
          'kubectl', '--context', 'my-context', '-n', 'mynamespace',
          'exec', 'postgres-helper-58dc64d7f4-cmkxl', '--',
          '/bin/bash', '-c', 'PAGER=cat psql postgresql://postgres:password@postgres-postgresql --list --quiet --tuples-only'
      ],
      check=True,
      capture_output=True
  )
  

• 方式2：添加psql的--no-pager参数

  result = subprocess.run(
      [
          'kubectl', '--context', 'my-context', '-n', 'mynamespace',
          'exec', 'postgres-helper-58dc64d7f4-cmkxl', '--',
          '/bin/bash', '-c', 'psql --no-pager postgresql://postgres:password@postgres-postgresql --list --quiet --tuples-only'
      ],
      check=True,
      capture_output=True
  )
  

补充说明 #

移除-it是最彻底的解决方案，因为捕获输出场景下完全不需要交互式终端的特性。如果需要处理标准输入，也可搭配stdin=subprocess.DEVNULL避免进程等待输入，但移除-it的方式更简洁高效。

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