Java调用shell脚本报open terminal failed: missing or unsuitable terminal

报错open terminal failed: missing or unsuitable terminal: unknown由终端类型环境变量缺失导致：

• ProcessBuilder启动的子进程不继承交互式终端的上下文，TERM环境变量未被赋值，默认值为unknown
• 命令中ssh -tt会强制在远端分配伪终端，tmux attach运行时需要校验合法的终端类型，读取到TERM=unknown就会直接抛出错误
• 直接在本地系统终端执行脚本时，终端已经预置了TERM=xterm-256color（或对应终端的合法类型值），因此可以正常运行。

以下方案任选其一即可，按改动成本从低到高排序：

• 方案1（最小改动，推荐）：显式注入TERM环境变量
  可以在Java代码中通过ProcessBuilder设置环境变量，不需要修改原有shell脚本逻辑：

  ProcessBuilder pb = new ProcessBuilder("/Users/user/eclipse-workspace/project/start.sh");
  // 传入tmux可识别的通用终端类型
  pb.environment().put("TERM", "xterm-256color");
  Process p = pb.start();
  BufferedReader stdInput = new BufferedReader(new InputStreamReader(p.getInputStream()));
  System.out.println("output: ");
  String s;
  while ((s = stdInput.readLine()) != null) {
      System.out.println(s);
  }
  

  也可以直接在shell脚本头部提前声明TERM变量，不需要修改Java代码：

  #! /bin/sh
  export TERM=xterm-256color
  ssh -tt -i ~/.ssh/ssh-key.key opc@___._.___.___ tmux attach -d << END 
      ./run.sh 
  END
  exit 0
  

• 方案2（适配非交互场景，稳定性最高）：替换tmux attach为send-keys逻辑
  如果只是需要在已有的远端tmux会话中触发脚本执行，不需要真正附着到会话上，直接用tmux的send-keys子命令即可，完全绕过终端类型校验，也不需要给ssh加-tt强制分配tty，适合后台自动化调用：

  #! /bin/sh
  # 将-t 后的0替换为你实际使用的tmux会话编号/名称
  ssh -i ~/.ssh/ssh-key.key opc@___._.___.___ tmux send-keys -t 0 './run.sh' C-m
  exit 0
  

• 方案3：执行tmux时临时指定终端类型
  如果必须保留tmux attach逻辑，可以在ssh的远端命令前直接声明TERM变量，不依赖外层环境传递：

  #! /bin/sh
  ssh -tt -i ~/.ssh/ssh-key.key opc@___._.___.___ TERM=xterm-256color tmux attach -d << END 
      ./run.sh 
  END
  exit 0
  

• 不要尝试通过去掉ssh的-tt参数解决问题：tmux运行必须依赖tty环境，去掉后会触发not a terminal类报错
• 不要将TERM设置为dumb等极简终端类型，tmux无法识别这类配置，通用的xterm/xterm-256color可以兼容绝大多数场景。

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