JupyterLab静态文件服务问题：无法下载生成的PDF文件

你的操作错误点 #

1. 重复覆盖配置项：你多次赋值c.ServerApp.extra_static_paths，最后一行的./files/会覆盖前面的绝对路径配置，而相对路径是基于Jupyter服务的启动目录，大概率不是你存放PDF的实际路径。
2. 无效配置项：c.ExtensionApp.static_paths是给Jupyter扩展用的，和静态文件下载服务无关，完全不需要设置。

可行配置方案 #

针对你的Notebook 7.2.1（基于Jupyter Server 2.14.1），正确配置步骤如下：

1. 创建固定的PDF存储目录
   先在系统里创建一个专门存放待下载PDF的文件夹，比如用户主目录下的jupyter_files：

   mkdir ~/jupyter_files
   

2. 修改Jupyter配置文件
   编辑jupyter_notebook_config.py（如果没有这个文件，先运行jupyter notebook --generate-config生成），添加以下配置（确保用绝对路径）：

   import os
   # 将本地文件夹映射到Jupyter的/files/URL路径下
   c.ServerApp.extra_static_paths = [os.path.join(os.environ['HOME'], 'jupyter_files')]
   

   注意：不要重复设置c.ServerApp.extra_static_paths，只保留这一行即可。

3. 重启Jupyter服务
   关闭当前所有Jupyter进程，重新启动Notebook服务，让配置生效。

4. 生成并放置PDF文件
   将你生成的PDF文件移动或保存到~/jupyter_files目录下，确保文件权限为可读（比如chmod 644 ~/jupyter_files/your_file.pdf）。

5. 正确编写下载链接
   在Notebook中使用以下代码生成下载链接：

   from IPython.display import HTML
   pdf_filename = "your_file.pdf"  # 替换成你的PDF文件名
   display(HTML(f'<a href="/files/{pdf_filename}">点击下载：{pdf_filename}</a>'))
   

验证逻辑 #

Jupyter Server会将extra_static_paths配置的本地目录，映射到服务的/files/URL路径下。当你点击链接时，服务会从你配置的本地文件夹里读取对应文件，返回给浏览器下载。

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