Laravel中使用Symfony执行Python脚本报错：Python不是内部或外部命令

之前配置不生效的核心原因 #

你此前自定义设置的ENV_VAR_NAME不属于Windows系统识别的可执行文件查找规则字段——Windows只会从系统PATH环境变量记录的路径列表中匹配python.exe，自定义命名的环境变量完全不会参与程序查找流程，自然无法解决Python识别失败的问题。

可直接落地的修复操作 #

• 方式一：修正环境变量配置逻辑
  不要自定义环境变量名，直接把Python安装目录追加到原有系统PATH变量中，避免覆盖原有系统配置。修改后的示例代码：

  // 先读取系统原有PATH配置，避免直接覆盖导致基础命令找不到
  $systemPath = getenv('PATH');
  $pythonInstallDir = 'C:\Users\hrish\AppData\Local\Programs\Python\Python39';
  $pythonScriptsDir = 'C:\Users\hrish\AppData\Local\Programs\Python\Python39\Scripts';
  
  $process = new Process(
      // 用Laravel路径助手拼接Python脚本绝对路径，解决相对路径找不到的问题
      ['python', base_path('top_movies.py')],
      null,
      [
          // 用Windows分号拼接原有路径和Python路径
          'PATH' => $systemPath . ';' . $pythonInstallDir . ';' . $pythonScriptsDir
      ]
  );
  $process->run();
  if (!$process->isSuccessful()) {
      // 捕获stderr错误输出，替代直接抛异常的模糊报错
      throw new \RuntimeException('Python脚本执行失败：' . $process->getErrorOutput());
  }
  $ar = $process->getOutput();
  

• 方式二：直接指定Python可执行文件绝对路径
  完全绕开环境变量匹配逻辑，在命令参数中写全python.exe的完整路径，从根源避免路径匹配失败：

  $process = new Process(
      [
          'C:\Users\hrish\AppData\Local\Programs\Python\Python39\python.exe',
          base_path('top_movies.py')
      ],
      base_path(), // 显式指定工作目录为项目根目录
      null
  );
  

额外避坑提示 #

• 禁止直接覆盖原有PATH配置：如果给PATH字段赋值时直接替换成只有Python目录的内容，会导致系统找不到cmd.exe等基础可执行程序，触发新的执行失败问题
• 做好路径转义适配：Windows下如果路径包含空格、特殊字符，要确保Symfony Process组件能正确解析路径参数，旧版本组件需要手动给路径加单引号包裹
• 补充脚本超时配置：长运行的Python脚本要通过$process->setTimeout(30)设置合理超时时间，避免被系统默认的短超时规则强制中断

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