【uwsgi】Mac下python dyld ：Library not loaded 问题解决

2021-10-21 18:06:05

今天在Mac下使用uwsgi运行Python Flask的web程序时遇到了dyld: Library not loaded问题，记录一下解决方法

问题

今天本来想使用uwsgi在本地运行一下之前编写的flask程序，以便部署到服务器，结果遇到了一个比较坑的问题。

本来我的Mac没有安装uwsgi，使用如下命令安装了uwsgi

1	pip3 install uwsgi

我的电脑上有Python2 和 Python3 两个环境，pip对应Python2 ，pip3 对应 Python3

安装了之后，运行flask官方文档的uwsgi的运行命令，结果遇到了如下问题

dongxiyan@MacBook-Pro ~ % uwsgi -s /tmp/app.sock --manage-script-name --mount /app=app:app
dyld: Library not loaded: @rpath/Python3.framework/Versions/3.8/Python3
  Referenced from: /Users/dongxiyan/Library/Python/3.8/bin/uwsgi
  Reason: image not found
zsh: abort      uwsgi

报了dyld: Library not loaded这个错，uwsgi运行不起来

解决步骤

经过一通google、百度，发现原因是在运行uwsgi时找不到了Python3的动态库，即该路径@rpath/Python3.framework/Versions/3.8/Python3不存在。

不应该啊，我记得我的电脑装了Python3的，猜想是不是Python2和Python3乱了环境，uwsgi去找了Python2的库，查看Python2和Python3的具体路径

dongxiyan@MacBook-Pro ~ % which /usr/bin/python
/usr/bin/python
dongxiyan@MacBook-Pro ~ % otool -L /usr/bin/python
/usr/bin/python:
	/System/Library/Frameworks/Python.framework/Versions/2.7/Python (compatibility version 2.7.0, current version 2.7.16)
	/usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1292.60.1)
dongxiyan@MacBook-Pro ~ % which /usr/bin/python3
/usr/bin/python3
dongxiyan@MacBook-Pro ~ % otool -L /usr/bin/python3
/usr/bin/python3:
	/usr/lib/libxcselect.dylib (compatibility version 1.0.0, current version 1.0.0)
	/usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1292.60.1)

otool -L /usr/bin/python 查看/usr/bin/python 的依赖
otool Mac 下的反编译工具

看到Python2 和 Python3 的依赖不一样，Python2下有依赖/System/Library/Frameworks/Python.framework/Versions/2.7/Python，按理说Python3也应该依赖/System/Library/Frameworks/Python.framework/Versions/3.8/Python，但是查出来的依赖里没有，查看/System/Library/Frameworks/Python.framework/Versions/路径下的文件，没有Python3的

1 2	dongxiyan@MacBook-Pro ~ % ls /System/Library/Frameworks/Python.framework/Versions/ 2.3 2.5 2.6 2.7 Current

但是我在命令行下运行Python3是没问题的，说明Python3的库不在这个目录下/System/Library/Frameworks/Python.framework/Versions/，/usr/bin/python3的依赖应该也没有问题，因为python3能成功运行

dongxiyan@MacBook-Pro ~ % python3
Python 3.8.2 (default, Dec 21 2020, 15:06:04) 
[Clang 12.0.0 (clang-1200.0.32.29)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>>

应该不是乱环境了，如果是乱环境了，应该是报dyld: Library not loaded: @rpath/Python.framework/Versions/2.7/Python这个错才对，估计原因是/System/Library/Frameworks/Python3.framework/Versions/3.8/Python3 这个的路径不存在，查一下，果然不存在

但为什么会不存在的呢？我的Python3在本地运行时没问题的啊，那应该就是Python3的运行路径不在上面那个路径下，这个路径要怎样设置才正确呢？

然后继续谷歌百度@rpath/Python3.framework/Versions/3.8/Python3相关内容，查到@rpath的意思是可执行程序内部设置的一组路径，那解决办法就是把我的本地Python3的路径添加到@rpath 下应该就行了，根据Python2的依赖，估计@rpath 指的就是/System/Library/Frameworks。

先找到本地Python3的运行路径，命令行下import sys sys.path

可以看到本地Python3的路径为/Applications/Xcode.app/Contents/Developer/Library/Frameworks/Python3.framework/Versions/3.8/lib/python3.8，原来使用的是Xcode的Python3环境，那把这个路径加到@rpath 下问题应该就解决了。

但是经过一通谷歌百度，也没找到@rpath 的添加方法，不过找到了修改uwsgi动态库依赖的方法，查看uwsgi的依赖

dongxiyan@MacBook-Pro ~ % otool -L /Users/dongxiyan/Library/Python/3.8/bin/uwsgi
/Users/dongxiyan/Library/Python/3.8/bin/uwsgi:
	/usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1292.60.1)
	/usr/lib/libz.1.dylib (compatibility version 1.0.0, current version 1.2.11)
	/usr/local/opt/pcre/lib/libpcre.1.dylib (compatibility version 4.0.0, current version 4.12.0)
	/usr/lib/libexpat.1.dylib (compatibility version 7.0.0, current version 8.0.0)
	/System/Library/Frameworks/CoreFoundation.framework/Versions/A/CoreFoundation (compatibility version 150.0.0, current version 1770.255.0)
	@rpath/Python3.framework/Versions/3.8/Python3 (compatibility version 3.8.0, current version 3.8.0)

只要把@rpath/Python3.framework/Versions/3.8/Python3改成正确的路径应该就行了，在这里把它换成Xcode的Python3路径

修改命令如下

install_name_tool -change @rpath/Python3.framework/Versions/3.8/Python3 /Applications/Xcode.app/Contents/Developer/Library/Frameworks/Python3.framework/Versions/3.8/Python /Users/dongxiyan/Library/Python/3.8/bin/uwsgi