NodeJS子进程运行Python时无法加载模型问题排查

这种问题我在调试Node和Python跨进程调用时碰到过好多次，核心原因基本都是两种运行方式的环境上下文不一样，给你列几个最常见的排查方向，你可以逐一验证：

• 工作目录不匹配
  直接运行Python脚本时，你的终端工作目录通常是脚本所在的文件夹（或者你手动切换到的路径），但Node.js的child_process.spawn/exec默认会使用Node进程的当前工作目录，而不是Python脚本的目录。如果你的Python代码里用了相对路径加载模型（比如./model_weights.bin），那子进程里的相对路径就会指向Node的工作目录，自然找不到模型。

  排查方法：在Python脚本里加一行打印当前工作目录的代码：

  import os
  print("Current working directory:", os.getcwd())
  

  对比单独运行和子进程运行时的输出，如果路径不一样，就实锤了这个问题。

  解决方法：在Node子进程的配置里指定cwd参数为Python脚本所在的目录：

  const { spawn } = require('child_process');
  const pythonProc = spawn('python', ['your_script.py'], {
    cwd: '/path/to/your/python/script/folder' // 替换成你的Python脚本实际路径
  });
  

• 环境变量缺失
  如果你的Python程序依赖环境变量来定位模型（比如用os.environ.get('MODEL_PATH')读取模型路径），那单独运行时你可能在终端里已经设置了这个变量，但Node子进程默认不会继承所有终端环境变量（尤其是如果Node是通过服务管理器启动的，比如systemd）。

  排查方法：在Python脚本里打印关键环境变量的值：

  import os
  print("MODEL_PATH:", os.environ.get('MODEL_PATH'))
  

  如果子进程运行时输出是None，说明环境变量没传过去。

  解决方法：在Node子进程的env参数里手动传递所需的环境变量：

  const { spawn } = require('child_process');
  const pythonProc = spawn('python', ['your_script.py'], {
    env: { ...process.env, MODEL_PATH: '/path/to/your/model' }
  });
  

• 文件权限差异
  直接运行Python时你用的是当前用户（比如你的个人账号），但Node进程可能运行在另一个用户下（比如服务器上的www-data或者node专用用户），这个用户没有读取模型文件的权限，也会触发“模型不存在”的错误（有些情况下权限不足会被包装成文件不存在的提示）。

  排查方法：看错误日志里的具体细节，如果有Permission denied的字样就实锤了；也可以在Python脚本里检查文件的可访问性：

  import os
  model_path = './model_weights.bin' # 换成你的模型路径
  print("File exists:", os.path.exists(model_path))
  print("File readable:", os.access(model_path, os.R_OK))
  

  如果readable是False，就需要调整模型文件的权限，比如：

  chmod o+r /path/to/model_weights.bin
  

  或者让Node进程以有权限的用户运行。

• 相对路径解析逻辑错误
  有些Python脚本里会尝试用__file__来获取脚本所在路径，但写法错误会导致路径解析失败。比如：

  # 错误写法：依赖当前工作目录，不可靠
  model_path = './models/model.bin'
  # 正确写法：基于脚本所在目录拼接绝对路径
  import os
  script_dir = os.path.dirname(os.path.abspath(__file__))
  model_path = os.path.join(script_dir, 'models', 'model.bin')
  

  如果你的Python脚本用了错误的路径拼接方式，那当工作目录变化时（比如Node子进程的cwd不同），就会找不到模型。

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