macOS环境下Jupyter Notebook插入本地图片路径报错404的问题咨询
404报错的核心成因
Jupyter Notebook的内置静态资源服务有严格的安全边界限制:它只会把你启动服务时终端所处的工作目录作为可访问的根路径,不允许读取、提供这个根目录范围外的任何本地文件。
你之前通过拖拽获取的 /Users/kloe/Desktop/screenshot20201005.png 是macOS系统层面的全路径,但Jupyter拿到这个路径后,并不会直接对接系统文件系统按这个绝对路径找文件,反而会把这个路径拼接在自身的服务根目录下做相对解析——也就是它实际在找的文件路径是「你的Jupyter服务根目录 + /Users/kloe/Desktop/screenshot20201005.png」,因为这个拼接出来的路径在服务根目录下根本不存在,所以终端才会抛出404的GET请求错误。
另外你写的路径最开头带了斜杠/,会进一步触发路径解析的根映射,直接把路径锚定在Jupyter的虚拟服务根下,完全偏离真实的文件存储位置。之前测试网络图片可以正常加载,是因为网络图片由浏览器直接向外部服务器发起请求获取,不经过Jupyter的本地文件权限校验,这也直接印证了问题出在Jupyter对本地文件的访问权限边界上。
可正常识别的本地图片路径获取方法
- 第一步先确认Jupyter的服务根目录:启动Jupyter后,看终端打印的启动日志,类似
[I 12:00:00.000 NotebookApp] Serving notebooks from local directory: /Users/xxx/yyy,后面标注的绝对路径就是所有本地文件的访问基准 - 第二步根据文件位置匹配写法:
- 如果图片存放在上述服务根目录范围内,就写从服务根目录开始的相对路径,不要带开头的斜杠。举个例子:如果Jupyter是从
/Users/kloe目录启动的,图片存在/Users/kloe/Desktop下,正确的Markdown写法是,正确的HTML写法是<img src='Desktop/screenshot20201005.png'> - 如果图片和当前的.ipynb笔记本文件放在同一个文件夹下,直接写图片文件名即可,比如
,不需要带任何路径前缀
- 如果图片存放在上述服务根目录范围内,就写从服务根目录开始的相对路径,不要带开头的斜杠。举个例子:如果Jupyter是从
- 不建议强行配置跨目录的绝对路径映射,既容易触发权限报错,也会破坏Jupyter的默认安全沙箱逻辑。
内容的提问来源于stack exchange,提问作者minikloe
相关产品推荐
相关产品推荐

