PyInstaller打包后pyshorteners库无法使用的问题及替代方案咨询

问题原因 #

pyshorteners内部采用动态导入加载pyshorteners.shorteners模块，PyInstaller的静态依赖分析无法自动识别该模块，导致打包后的可执行文件缺失此依赖。

解决方法 #

方法1：打包时添加--hidden-import参数 #

直接在PyInstaller命令中手动指定缺失的模块：

pyinstaller --hidden-import pyshorteners.shorteners main.py

如果后续出现其他同类模块缺失错误，继续追加--hidden-import参数即可，例如--hidden-import pyshorteners.shorteners.tinyurl。

方法2：修改.spec文件 #

1. 先生成默认的spec配置文件：

pyinstaller main.py

2. 打开生成的main.spec文件，找到hiddenimports列表，添加缺失模块：

hiddenimports=['pyshorteners.shorteners'],

3. 使用修改后的spec文件重新打包：

pyinstaller main.spec

方法3：在脚本中显式导入模块 #

在Python脚本开头添加显式导入语句，让PyInstaller的静态分析能检测到该依赖：

import pyshorteners.shorteners

# 原有业务代码
def Shorten_Link(link):
    shortener = pyshorteners.Shortener()
    return shortener.tinyurl.short(link)

之后正常执行PyInstaller打包命令即可。

简便替代方案 #

如果仅需TinyURL的链接缩短功能，可以直接调用其公开API，无需依赖pyshorteners库，示例代码如下：

import requests

def Shorten_Link(link):
    try:
        resp = requests.get(f"http://tinyurl.com/api-create.php?url={link}")
        resp.raise_for_status()
        return resp.text
    except requests.exceptions.RequestException as e:
        print(f"链接缩短失败: {str(e)}")
        return None

该方式仅依赖requests库，PyInstaller可自动识别其依赖，打包时不会出现模块缺失问题。

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