关于api-fast的python项目后端打包成exe

1.通过pip命令进行安装pyInstaller

pip install pyinstaller

2.安装完成后，可以通过以下命令验证是否安装成功：

pyinstaller --version

3.在项目根目录下运行以下命令，生成配置文件：（项目主脚本为app.py)

• --onefile 表示将所有文件打包成一个单独的exe文件。
• --windowed 表示不显示命令行窗口（适用于GUI应用）。

#默认是项目名app

pyinstaller --onefile --windowed app.py

#或者自己命名为my_app

pyinstaller --onefile --windowed --name=my_app app.py

运行该命令后，pyInstaller会生成一个名为app.spec的配置文件（也可以自己命名）。

4.打开生成的main.spec文件，可以根据需要进行修改main.spec，将需要加载的依赖文件路径加入app.spec文件中，需要逐一排查依赖文件，以下是我引用文件的路径。

# -*- mode: python ; coding: utf-8 -*-


a = Analysis(
    ['app.py'],
    pathex=[],
    binaries=[
        ("assets/font/*.ttf", "assets/font"),
        (r'D:\Python\Python313\Lib\site-packages\asyncmy\*.pyd', 'asyncmy'),
        (r"D:\Python\Python313\Lib\site-packages\PIL\*.pyd", "PIL"),
    ],
    datas=[
        ("assets/font/*.ttf", "assets/font"),
        (r"D:\Python\Python313\Lib\site-packages\PIL\*.py", "PIL"),
        (r'D:\Python\Python313\Lib\site-packages\asyncmy\*.py', 'asyncmy'),
        (r'D:\Python\Python313\Lib\site-packages\asyncmy\constants\*.py', 'asyncmy/constants'),
        (r'D:\Python\Python313\Lib\site-packages\sqlalchemy\dialects\mysql\asyncmy.py', 'sqlalchemy/dialects/mysql'),
        (r'D:\Python\Python313\Lib\site-packages\passlib\handlers\bcrypt.py', 'passlib/handlers'),
        (r'D:\Python\Python313\Lib\site-packages\loguru\*.py', 'loguru'),
    ],
    hiddenimports=[
        'asyncmy.auth',
        'asyncmy.charset',
        'asyncmy.optionfile',
        'asyncmy.connection',
        'asyncmy.cursors',
        'asyncmy.contexts',
        'asyncmy.converters',
        'asyncmy.errors',
        'asyncmy.version',
        'asyncmy.optionfile',
        'asyncmy.pool',
        'asyncmy.protocol',
        'asyncmy.structs',
        'asyncmy.constants',
        'asyncmy.constants.COLUMN',
        'asyncmy.constants.CLIENT',
        'asyncmy.constants.COMMAND',
        'asyncmy.constants.CR',
        'asyncmy.constants.ER',
        'asyncmy.constants.FIELD_TYPE',
        'asyncmy.constants.FLAG',
        'asyncmy.constants.SERVER_STATUS',
        'sqlalchemy.ext.asyncio',
        'sqlalchemy.dialects.mysql.asyncmy',
        'cryptography.hazmat.backends.openssl',
        'cryptography.hazmat.bindings._rust',
        'passlib.handlers.bcrypt',  # 关键修复
        'passlib.handlers',      # 覆盖其他处理器
        'python-multipart', 'zmq', 'py7zr', 'psutil',
        'app'  # 显式添加主模块
    ],
    hookspath=['.'],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[
        'multiprocessing.Pool' # 进一步禁用多进程池
    ],
    noarchive=False,
    optimize=0,
)
pyz = PYZ(a.pure)

exe = EXE(
    pyz,
    a.scripts,
    a.binaries,
    a.datas,
    [],
    name='app',
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,
    upx_exclude=[
        'asyncmy*',
        'passlib*'  # 排除 passlib 压缩
    ],
    runtime_tmpdir=None,
    console=True,
    disable_windowed_traceback=False,
    argv_emulation=False,
    target_arch=None,
    codesign_identity=None,
    entitlements_file=None,
)

5.修改完成后，再次运行PyInstaller命令打包生成exe文件:

(打包完成后，生成的exe文件将位于dist文件夹中)

pyinstaller app.spec

6.测试exe文件是否能用

将生成的exe文件复制到其他机器上运行，确保没有依赖问题，并且功能正常。

如果生成的exe文件过大，可以考虑以下优化：

• 使用UPX工具进行压缩。
• 精简项目代码，移除不必要的依赖。
• 调整PyInstaller配置，减少冗余文件。

7.常见问题

• 缺少依赖库：确保所有依赖库都已经打包，可以通过hiddenimports选项添加隐藏依赖。
• 路径问题：确保项目中使用的路径都是相对路径，避免硬编码。
• 资源文件未打包：在datas选项中添加资源文件路径。

本人遇到的问题：

1.总是说我的文字没有加载出来，解决方法：将加载文字的文件写成绝对路径，如下：

一般在captcha_service.py文件中改写

 # 指定字体文件的绝对路径
        font_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "assets", "font", "arial.ttf")
        # 使用绝对路径加载字体
        font = ImageFont.truetype(font_path, 24)

2.如果有外部的redis依赖（redis需要自己下载压缩包解压），运行redis-server程序后再跑后端哦，不然就会报500错误