Ruby使用curses gem时thread.join无法返回的问题排查

核心原因 #

Windows下Ruby的curses库会接管控制台的输入输出处理，这会干扰Ruby线程间的全局变量可见性，甚至导致GIL（全局解释器锁）被curses的底层IO操作长期持有，使得子线程无法及时感知全局变量$cont的变化。另外，curses退出时如果没有正确清理资源，会导致控制台处于异常状态，进一步阻塞线程的join操作。

解决方案 #

1. 使用线程安全的终止信号替代全局变量

放弃依赖全局变量的轮询，改用Queue或者带Mutex保护的变量传递终止信号，确保线程间状态同步：

require 'curses'
require 'thread'

# 用线程安全的Queue作为终止信号
stop_queue = Queue.new

uart_thread = Thread.new do
  loop do
    # 非阻塞检查终止信号
    break unless stop_queue.empty?
    # 串口操作逻辑
    # 注意：避免在子线程中操作控制台输出，改用日志文件等方式
    sleep 0.5
  end
  puts "UART thread exited"
end

Curses.init_screen
Curses.cbreak
Curses.noecho
Curses.stdscr.keypad(true)

begin
  loop do
    ch = Curses.getch
    if ch == '5'.ord
      # 发送终止信号
      stop_queue << :stop
      break
    end
  end
ensure
  # 必须正确清理curses资源
  Curses.endwin
  Curses.close
end

puts "Before join"
uart_thread.join
puts "After join"

2. 用Mutex保护全局变量的状态更新

如果必须依赖全局变量，要加Mutex保证线程安全，同时确保curses资源先清理：

require 'curses'
require 'thread'

$cont = true
$mutex = Mutex.new

uart_thread = Thread.new do
  loop do
    $mutex.synchronize do
      break unless $cont
    end
    # 串口操作逻辑
    sleep 0.5
  end
end

Curses.init_screen
Curses.cbreak
Curses.noecho

begin
  while ch = Curses.getch
    if ch == '5'.ord
      $mutex.synchronize do
        $cont = false
      end
      break
    end
  end
ensure
  # 先清理curses，避免控制台异常阻塞线程
  Curses.endwin
  Curses.close
end

puts "Before join"
# 超时等待，避免无限阻塞
if uart_thread.join(3).nil?
  uart_thread.terminate
  puts "UART thread terminated forcefully"
end
puts "After join"

3. 避免控制台资源竞争

curses会独占控制台的输入输出，子线程里尽量不要用puts这类直接输出操作，改用日志文件或者内存缓冲区记录状态，减少线程间的控制台资源竞争。

关键注意点 #

• Windows下curses退出时必须调用Curses.endwin和Curses.close，否则控制台会处于不可交互状态，直接导致线程阻塞。
• Ruby多线程的全局变量默认没有内存可见性保证，必须用同步机制（Mutex/Queue/ConditionVariable）确保状态在线程间正确传递。
• 尽量避免用Thread#exit强制终止线程，尤其是涉及IO操作的线程，优先用优雅的终止方式，防止资源泄漏。

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