PyCharm远程调试Jython脚本失败求助：子进程场景排查

我之前碰到过类似的Jython远程调试卡壳的情况，结合你的场景（Python3.5启动Java子进程，Java内部调用Jython2.5脚本），大概率是以下几个环节出了问题，咱们一步步来排查：

• 确认pycharm-debug.egg的兼容性与路径正确性
  Jython2.5属于比较老的版本，你得确保用的pycharm-debug.egg是对应PyCharm 2018.1.2版本的，而且是适配Python2.x的（毕竟Jython2.5对齐Python2语法）。另外，一定要验证libspath指向的路径确实包含这个egg文件——可以在sys.path.append之后加一行print(sys.path)，把Jython的输出打出来，看看这个egg的路径是不是真的被加入到了搜索路径里。如果路径错了，import pydevd会直接报错，只是你可能没看到这个错误。

• 检查网络连接与端口可用性
  你用localhost作为调试主机，有时候Ubuntu系统的hosts配置或者网络命名空间可能会导致解析问题，试试把pydevd.settrace里的主机改成127.0.0.1。另外，检查9999端口有没有被其他进程占用：

  lsof -i :9999
  

  如果有占用，换个端口试试。同时确认Ubuntu防火墙没有拦截这个端口，临时关闭防火墙测试：

  sudo ufw disable
  

  能连上的话再去配置防火墙规则允许9999端口入站。

• 调整pydevd.settrace的参数适配Jython
  Jython的运行机制和CPython有差异，老版本的pydevd在Jython下可能需要调整参数。试试在settrace里加上patch_multiprocessing=False，同时确认脚本确实执行到了调试代码——在pydevd.settrace前加一行print("About to attach to PyCharm debugger...")，看Java的输出里有没有这句话，确保Jython脚本是真的被执行到了这一步，而不是Java进程还没走到调用Jython的逻辑。

  修改后的代码：

  sys.path.append(os.path.join(libspath, "pycharm-debug.egg"))
  import pydevd
  pydevd.settrace('127.0.0.1', port=9999, stdoutToServer=True, stderrToServer=True, suspend=True, patch_multiprocessing=False)
  

• 核对PyCharm远程调试配置的细节
  你在PyCharm里创建的必须是「Python Remote Debug」类型的配置：

  • 确保Host填的是127.0.0.1，端口是9999，并且勾选了「Allow incoming connections」
  • 关键是路径映射：在配置的「Path Mappings」里，把本地PyCharm项目中Jython脚本的目录，和Ubuntu上Jython脚本实际运行的目录对应起来。如果路径映射错了，PyCharm就算连上了也找不到断点对应的文件。

• 检查subprocess的环境变量继承
  Python3.5启动subprocess时，默认会继承父进程的环境变量，但有时候Java进程可能缺失调试需要的环境信息。试试在subprocess.run里显式传递环境变量：

  import os
  subprocess.run(["/usr/bin/java","-jar",<pathToMyJar>], env=os.environ.copy())
  

  这样能确保Java进程拿到父进程的所有环境变量，包括可能和PyCharm调试相关的变量。另外，也可以在Java进程里打印环境变量，确认PYTHONPATH包含了pycharm-debug.egg的路径。

• 捕获Java进程的输出排查错误
  你可能没看到Jython脚本执行时的报错信息，试试在启动subprocess时捕获输出：

  result = subprocess.run(["/usr/bin/java","-jar",<pathToMyJar>], capture_output=True, text=True)
  print("STDOUT:", result.stdout)
  print("STDERR:", result.stderr)
  

  这样能看到Jython脚本在导入pydevd或者启动调试时有没有抛出异常，比如模块找不到、端口连接失败之类的错误，这些信息能帮你快速定位问题。

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