打包hikari Discord机器人为exe时报找不到hikari/banner.txt文件如何解决

不需要更换编程语言重写程序，通过调整打包配置+少量入口代码适配即可正常打包，以下是可直接复用的操作步骤，优先推荐使用PyInstaller操作，autopytoexe是PyInstaller的图形封装版本、py2exe的配置逻辑完全一致。

问题根因 #

hikari框架启动时会读取自身安装目录下的banner.txt静态资源文件，PyInstaller、py2exe这类打包工具默认仅收集.py格式的代码文件，不会自动打包框架依赖的非代码静态资源，同时打包后程序运行时会将资源解压到临时目录，hikari默认的路径读取逻辑无法定位到该临时目录，最终触发文件不存在的报错。

操作步骤 #

• 配置打包参数，显式收集hikari全量依赖
  直接在PyInstaller打包命令中加入全量收集参数，会自动包含hikari的所有子模块、静态资源（含缺失的banner.txt），无需手动逐个找资源文件，Windows环境下参考命令：
  pyinstaller -F 你的机器人入口文件.py --collect-all hikari
  如果使用autopytoexe，在高级配置的「收集全部包」输入框中填入hikari即可；如果使用py2exe，在配置文件的options段加入hikari的包收集规则，将hikari目录下的所有非代码文件加入data_files映射。
• 适配打包后的运行时路径
  在机器人代码的最顶部（所有hikari相关导入语句之前）加入如下代码，指定hikari的资源读取路径，兼容打包后临时解压目录的寻址逻辑：

  import sys
  import os
  
  # 识别PyInstaller打包后的运行环境
  if getattr(sys, "frozen", False):
      hikari_resource_path = os.path.join(sys._MEIPASS, "hikari")
      os.environ["HIKARI_RESOURCE_PATH"] = hikari_resource_path
  

  注意：上述代码必须放在所有hikari相关导入语句之前执行，否则环境变量配置不会生效，依然会触发路径报错。
• 常见问题处理
  如果运行时还出现部分动态加载模块找不到的报错，在打包命令中追加--hidden-import参数补全对应模块名即可，大部分场景下仅--collect-all hikari参数就可以覆盖所有依赖需求。

效果验证 #

按上述配置打包后生成的exe可直接在无Python环境的Windows设备上运行，不会再触发banner.txt找不到的报错，机器人可正常登录、响应指令。

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