部署含DataModule单元的自定义BPL时FireDAC相关BPL找不到的问题排查

项目背景 #

项目包含以下组件：

• PkagDemmo.exe（主应用程序）
• AppAddin.bpl（用于加载/卸载BPL及创建窗体工具）
• PkgData.bpl（包含数据访问用的DataModule单元）
• Pakage1.bpl（包含Form1并展示数据的BPL）
• Pakage2.bpl（包含Form2并展示数据的BPL）

主程序PkagDemmo.exe的项目选项设置：

• Packages/Runtime Packages/Link with runtime Package = true
• Packages/Runtime Packages/Runtime packages = true

问题现象 #

开发电脑上应用运行正常，但将上述5个文件复制到Win10笔记本后，运行PkagDemmo.exe时提示找不到FireDACCommonDriver270.Bpl、FireDACCommon270.Bpl、FireDACCommonODBC270.Bpl、vclFireDac270.Bpl等文件。这些是PkgData.bpl的DataModule引用的FireDAC相关动态库，且已将这些BPL复制到笔记本，但仍报错。

原因分析及解决办法 #

1. 动态库路径未被系统识别 #

Windows加载动态链接库时，会按当前程序目录→系统目录→PATH环境变量目录的顺序查找。若你复制的FireDAC BPL不在这些路径范围内，程序就无法找到它们。

• 解决：将所有FireDAC相关BPL放到PkagDemmo.exe所在的同一目录；或者把这些BPL所在的目录添加到系统的PATH环境变量中。

2. BPL版本/架构不匹配 #

• 版本问题：确保复制的FireDAC BPL是来自Delphi 10.4.2（对应版本号270）的安装目录，比如32位程序对应的路径一般是C:\Program Files (x86)\Embarcadero\Studio\21.0\bin，不要混用其他Delphi版本的BPL。
• 架构问题：检查主程序编译的是32位还是64位版本，复制的BPL必须和程序架构一致（32位程序对应32位BPL，64位对应64位），否则会出现加载失败或找不到的错误。

3. 遗漏基础运行时BPL #

FireDAC的BPL依赖Delphi基础运行时库，比如rtl270.bpl、vcl270.bpl等。主程序启用了动态链接运行时包，这些基础BPL也需要一并部署到笔记本上，否则FireDAC的BPL无法正常加载。

4. 特殊驱动依赖问题 #

如果使用了ODBC等特殊驱动，需确保对应的驱动组件已正确注册，或者将相关驱动文件（如ODBC驱动的DLL）也部署到对应路径。

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