<think>我们使用PyInstaller将Python脚本打包成可执行文件，同时需要包含Oracle客户端的运行环境，以确保在没有安装Oracle客户端的机器上也能运行。 步骤： 1. 安装PyInstaller：`pip install pyinstaller` 2. 确保Oracle Instant Client已下载并解压到某个目录（例如：instantclient_19_10） 3. 在打包时，通过`--add-data`参数将Oracle Instant Client的目录包含到可执行文件中，并设置环境变量。 注意：在代码中，我们使用了cx_Oracle，它依赖于Oracle Instant Client的动态链接库。打包时需要将这些动态库一起打包。 具体操作： 假设Oracle Instant Client解压在`C:\instantclient_19_10`（Windows）或`/opt/oracle/instantclient_19_10`（Linux），我们可以通过以下方式打包： 命令示例（Windows）： ``` pyinstaller --onefile --add-data "C:\instantclient_19_10;instantclient_19_10" --paths "C:\instantclient_19_10" main.py ``` 命令示例（Linux）： ``` pyinstaller --onefile --add-data "/opt/oracle/instantclient_19_10:instantclient_19_10" --paths "/opt/oracle/instantclient_19_10" main.py ``` 解释： - `--onefile`: 打包成单个可执行文件。 - `--add-data`: 将本地的Oracle客户端目录添加到打包文件中，冒号前面是本地路径，后面是打包后的目录名（在可执行文件运行时，这些文件会被解压到临时目录，并且该目录会被添加到环境变量PATH中）。 - `--paths`: 在打包时添加额外的模块搜索路径，这里添加Oracle客户端路径是为了让cx_Oracle在打包时能够找到依赖。 另外，在代码中，我们需要在运行时设置Oracle客户端路径。可以使用cx_Oracle的`init_oracle_client`函数，但注意cx_Oracle版本需要>=8.0。我们可以在代码开头添加： ```python import cx_Oracle import os import sys # 判断是否为打包后的可执行文件 if getattr(sys, 'frozen', False): # 如果是，则设置解压后的Oracle客户端路径 bundle_dir = sys._MEIPASS oracle_client_dir = os.path.join(bundle_dir, 'instantclient_19_10') cx_Oracle.init_oracle_client(lib_dir=oracle_client_dir) else: # 如果不是打包环境，则正常使用系统环境变量中的Oracle客户端 pass ``` 但是，注意在代码中，我们使用的是`cx_Oracle.makedsn`和`cx_Oracle.connect`，所以需要确保在连接数据库之前已经初始化了Oracle客户端。 因此，修改代码：在`db_connect`函数之前，确保已经初始化了Oracle客户端（在打包环境下）。我们可以在程序入口处（`if __name__ == "__main__":`）之前添加上述初始化代码。 由于我们使用的是cx_Oracle 7.x或8.x，请注意版本兼容性。如果版本较低，可能需要升级：`pip install --upgrade cx_Oracle` 另外，由于程序使用了pandas, numpy, seaborn, matplotlib等，这些库在打包时会被自动包含，但需要注意这些库的依赖。 最后，我们执行打包命令。打包完成后，在dist目录下会生成可执行文件（Windows为main.exe，Linux为main）。注意，打包后的文件较大，因为包含了Python解释器和所有依赖库。 注意：在非Windows系统下打包，生成的是该平台的可执行文件，不能跨平台运行。 总结步骤： 1. 升级cx_Oracle到最新版本（至少8.0以上，因为init_oracle_client从8.0开始支持）。 2. 在代码中增加初始化Oracle客户端的代码（处理打包环境）。 3. 下载对应平台的Oracle Instant Client（注意与打包平台一致，比如Windows用Windows版本，Linux用Linux版本）。 4. 使用PyInstaller命令打包，并包含Oracle Instant Client目录。 代码修改示例（在main.py顶部）： ```python # ... 其他import ... import cx_Oracle import os import sys # 判断是否为打包环境 if getattr(sys, 'frozen', False): # 打包后的临时目录 base_dir = sys._MEIPASS oracle_client_dir = os.path.join(base_dir, "instantclient_19_10") # 初始化Oracle客户端 try: cx_Oracle.init_oracle_client(lib_dir=oracle_client_dir) except cx_Oracle.ProgrammingError as e: # 已经初始化过则跳过 pass else: # 非打包环境，尝试从环境变量初始化（或者系统默认路径） pass ``` 注意：如果使用cx_Oracle 7.x，则不支持`init_oracle_client`，需要手动设置环境变量。但为了兼容性，建议升级到8.x。 如果因为某些原因不能升级，则可以在打包前将Oracle Instant Client的路径添加到环境变量，但这样在打包时就需要确保运行环境有该环境变量，不够灵活。因此推荐升级cx_Oracle并使用上述初始化方法。 另外，在打包过程中可能会遇到隐藏导入的问题，比如PyInstaller无法自动检测到某些库，我们可以通过`--hidden-import`来指定。例如，如果遇到pandas的缺失模块，可以添加`--hidden-import pandas._libs.tslibs.timedeltas`等。具体需要根据打包时的错误提示添加。 由于程序较大，打包可能需要一些时间，并且生成的可执行文件也会比较大。 最后，测试打包后的可执行文件是否可以在没有安装Python和Oracle客户端的机器上运行。 </think> 要将包含Oracle依赖的Python脚本打包成独立可执行文件，确保在无环境机器上运行，需按以下步骤操作： ### 完整打包方案 #### 1. 安装必要工具 ```bash pip install pyinstaller cx_Oracle ``` #### 2. 集成Oracle Instant Client 1. **下载轻量版客户端**： - 从[Oracle官网](https://www.oracle.com/database/technologies/instant-client/downloads.html)下载对应系统的**Basic Lite**包（约50MB） - 示例：Windows 64位下载 `instantclient-basiclite-windows.x64-19.21.0.0.0dbru.zip` 2. **解压到项目目录**： ```bash unzip instantclient-basiclite-windows.x64-*.zip -d oracle_client ``` #### 3. 修改代码添加客户端初始化 在`main.py`开头添加： ```python import cx_Oracle import os import sys # 检测打包环境并初始化Oracle客户端 if getattr(sys, 'frozen', False): base_dir = sys._MEIPASS client_dir = os.path.join(base_dir, "oracle_client") cx_Oracle.init_oracle_client(lib_dir=client_dir) else: # 开发环境使用系统配置 pass ``` #### 4. 创建打包配置文件`hook-cx_Oracle.py` ```python from PyInstaller.utils.hooks import collect_dynamic_libs binaries = collect_dynamic_libs("cx_Oracle") datas = [("oracle_client", "oracle_client")] ``` #### 5. 执行打包命令 ```bash pyinstaller --onefile ^ --add-data "oracle_client;oracle_client" ^ --hidden-import=cx_Oracle ^ --hookspath . ^ --name equipment_anomaly_detector ^ main.py ``` #### 6. 验证打包结果 ```bash # 测试可执行文件 dist/equipment_anomaly_detector.exe --test-run ``` ### 关键注意事项 1. **版本匹配**： - 确保`cx_Oracle`与Instant Client版本匹配 - 推荐组合：cx_Oracle 8.3 + Instant Client 19.x 2. **依赖精简**： - 使用`Basic Lite`而非完整客户端 - 在`pyinstaller`中排除无用库： ```bash --exclude-module matplotlib --exclude-module seaborn ``` 3. **跨平台处理**： - Windows：需额外打包`oci.dll`和`oraons.dll` - Linux：需设置`LD_LIBRARY_PATH` - macOS：需签名动态库避免权限问题 4. **配置文件管理**： - 将数据库凭证移出代码，改用外部`config.ini` - 示例配置： ```ini [DATABASE] host = 10.11.24.178 port = 1521 service_name = FDWPDB ``` ### 最终交付结构 ``` equipment_anomaly_detector.exe # 主程序 oracle_client/ # 嵌入式客户端 ├─ oci.dll ├─ oraons.dll └─ ... config.ini # 配置文件 README.txt # 使用说明 ```