C# 斑馬打印機串口通信衝突導致打印卡死：協議與端口排查指南

C# 控制斑馬條碼打印機打印，初始正常，但進行其他串口通信操作後打印卡死，重啟打印機恢復。這通常是串口協議衝突或端口資源佔用導致。本文分析原因並提供排查方案。

現象描述

• 程序啟動後 PrintBarCode 正常打印
• 執行系統其他 SerialPort 通信操作後
• 再次打印卡死在 WriteFile（Printer.Write）
• 重啟打印機（不重啟程序）恢復正常

核心代碼片段

public bool Write(string Mystring) {
    if (iHandle != -1) {
        int i;
        OVERLAPPED x;
        byte[] mybyte = Encoding.Default.GetBytes(Mystring);
        return WriteFile(iHandle, mybyte, mybyte.Length, out i, out x); // 卡死在這裡
    }
    throw new Exception("端口未打開!");
}

原因分析

1. 協議衝突（最可能）

• 條碼打印機通常使用串口（RS232/USB 轉串口）
• 系統其他串口通信發送的數據被打印機接收
• 打印機無法識別非指令數據，進入錯誤狀態，緩衝區滿或等待協議結束符
• 後續正常打印指令發送失敗，WriteFile 阻塞

2. 端口資源衝突

• 多個 SerialPort 對象嘗試打開同一物理端口
• 或未正確關閉端口（Close() 未調用、異常未處理）
• 導致句柄無效或共享違規

3. 打印機內部狀態機異常

• 接收到非法數據後，打印機協議解析器進入死循環或等待狀態
• 重啟打印機可重置內部狀態機

排查步驟

1. 物理隔離：打印機與其他串口設備使用不同物理串口（不同 COM 號），避免數據幹擾
2. 協議封裝：給打印機指令添加明確的幀頭/幀尾/校驗，打印機固件若支持，啟用協議過濾
3. 端口獨佔：打印機端口打開後全程保持打開，避免反覆開關；其他設備用獨立端口對象
4. 發送前清空緩衝區：

   
       serialPort.DiscardOutBuffer();
       serialPort.DiscardInBuffer();
       

5. 超時設置：設置 WriteTimeout 防止無限阻塞

   
       serialPort.WriteTimeout = 2000; // 2秒
       

6. 異常處理與重試：

   
       try { printer.Write(cmd); } 
       catch (TimeoutException) { 
           // 重新打開端口、重發或報警
           printer.Close(); 
           printer.Open(); 
           printer.Write(cmd); 
       }
       

代碼改進建議

public static void PrintBarCode(...) {
    // 使用 using 確保資源釋放
    using (var printer = new Printer()) {
        printer.DevicePath = devicePath;
        if (!printer.Open()) return;
        
        // 發送前清空
        // 假設 Printer 內部暴露 SerialPort
        printer.ClearBuffers(); 
        
        bool success = printer.Write(cmd.ToString());
        if (!success) {
            // 記錄日誌、重試邏輯
        }
        printer.Close();
    }
}

根治方案

若業務允許，將打印機遷移至網絡接口（TCP/IP），完全避免串口衝突：

• 打印機連接網口打印服務器或自帶 WiFi/網口
• C# 使用 TcpClient 或 Socket 發送指令
• 與串口通信完全隔離，穩定性大幅提升