Kubernetes部署中调用API无法识别主机虚拟串口问题排查

核心问题：挂载路径不匹配 #

你的Kubernetes Deployment将主机的/dev目录挂载到了容器内的/host-dev，但Node.js API中执行的是ls /dev/ttyV*，这会查询容器自身的/dev目录，而非主机的/dev，所以无法找到主机上的ttyV0和ttyV1。

分步排查与修复 #

1. 修正API中的路径 #

将API里的路径从/dev/ttyV*改为/host-dev/ttyV*，同时后续的stty命令也要对应调整路径：

app.get('/serial-ports', (req, res) => {
  console.log("API pour les ports virtuels appelée...");

  // 替换路径为/host-dev
  execFile('ls /host-dev/ttyV* 2>/dev/null', async (error, stdout, stderr) => {
    if (error || stderr) {
      return res.status(500).json({ error: 'Erreur lors de la détection des ports virtuels.' });
    }

    const ports = stdout.split('\n').filter(line => line.trim() !== '');

    const portInfos = await Promise.all(
      ports.map(portPath => new Promise(resolve => {
        // 使用容器内的挂载路径执行stty
        execFile(`stty -a -F ${portPath}`, (err, sttyOutput) => {
          if (err) {
            return resolve({ port: portPath, error: 'Erreur récupération infos' });
          }

          const baud = sttyOutput.match(/speed (\d+) baud/)?.[1] || 'unknown';
          const dataBits = sttyOutput.match(/\bcs(5|6|7|8)\b/)?.[0] || 'unknown';
          const parity = sttyOutput.includes('parenb')
            ? (sttyOutput.includes('parodd') ? 'odd' : 'even')
            : 'none';
          const stopBits = sttyOutput.includes('cstopb') ? '2' : '1';
          const flowControl =
            sttyOutput.includes('crtscts') ? 'hardware' :
            (sttyOutput.includes('ixon') || sttyOutput.includes('ixoff')) ? 'software' :
            'none';
          const mode = sttyOutput.includes('icanon') ? 'canonical' : 'non-canonical';
          const echo = sttyOutput.includes('echo');

          resolve({
            port: portPath.replace('/host-dev/', ''), // 修正路径前缀
            path: portPath,
            baudRate: baud,
            dataBits,
            parity,
            stopBits,
            flowControl,
            mode,
            echo
          });
        });
      }))
    );
    res.json(portInfos);
  });
});

2. 验证容器内的挂载有效性 #

进入运行中的容器，执行以下命令确认主机串口是否可见：

kubectl exec -n camera <你的pod名称> -- ls /host-dev/ttyV*

如果输出ttyV0和ttyV1，说明挂载正常；如果没有输出，检查主机上的设备是否存在，以及Kubernetes的hostPath挂载配置是否正确。

3. 确认主机上的socat进程状态 #

虚拟串口依赖socat进程运行，若进程退出，设备节点会自动消失。在主机上执行以下命令确认进程状态：

ps aux | grep socat

确保socat以后台持续运行的方式启动，例如使用nohup socat <参数> &或配置为systemd服务。

4. 检查设备节点权限 #

主机上的ttyV0/ttyV1权限可能限制容器访问，在主机上查看权限：

ls -l /dev/ttyV*

如果权限未开放给其他用户，可临时调整权限测试：

sudo chmod 666 /dev/ttyV0 /dev/ttyV1

5. 替换ls命令避免通配符问题 #

Alpine使用busybox的ls命令，当通配符匹配不到文件时会直接输出通配符字符串而非空。可以改用find命令更可靠：

execFile('find /host-dev -name "ttyV*" -type c', async (error, stdout, stderr) => {
  // 后续逻辑不变
});

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