Apache Toree内核默认Lib Jars文件夹配置失效问题排查

你的配置未生效可能由以下几个原因导致，逐一排查：

1. kernel.json的argv未引用__TOREE_OPTS__占位符 #

Apache Toree的kernel.json中，__TOREE_OPTS__是一个参数占位符，需要在argv数组中明确声明，才能将你配置的参数传递给Toree启动命令。

检查你的kernel.json，确保argv数组包含__TOREE_OPTS__项，示例正确结构：

{
  "display_name": "Apache Toree Scala",
  "language": "scala",
  "argv": [
    "/path/to/your/toree/bin/run.sh",
    "--profile",
    "{connection_file}",
    "__TOREE_OPTS__"
  ],
  "env": {
    "__TOREE_OPTS__": "--jar-dir=./lib/"
  }
}

如果argv中缺少__TOREE_OPTS__，添加后重启Jupyter服务。

2. 相对路径./lib/的工作目录不匹配 #

--jar-dir的相对路径是相对于Jupyter服务器的启动目录，而非你当前Notebook所在的项目目录。比如你在~/projects/my_notebook下打开Notebook，但Jupyter是在~/目录启动的，那么./lib/指向的是~/lib/，而非~/projects/my_notebook/lib/，自然找不到你的自定义JAR包。

解决这个问题有两种思路：

• 启动Jupyter时切换到你的项目目录，再启动服务，此时./lib/会指向项目下的lib文件夹；
• 使用绝对路径指定lib目录，比如--jar-dir=/home/your_user/projects/my_notebook/lib/，但这种方式只能固定加载单个项目的JAR。

3. 未重启Jupyter服务 #

修改kernel.json后，必须完全关闭并重启Jupyter服务，新的内核配置才能生效。如果只是刷新Notebook页面，内核仍会使用旧的启动参数。

4. 权限问题 #

确保Toree启动的用户对./lib/目录及其中的JAR包有读取权限。可以通过以下命令检查并调整权限：

chmod -R 755 ./lib/

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