Erlang多模块打包实战：escript工具详解

1. Erlang项目打包需求解析

在Erlang生态中，我们经常需要将多个功能模块打包成单个可执行文件进行分发部署。传统方式需要用户安装完整的Erlang运行时环境（ERTS），这对终端用户极不友好。通过escript工具，我们可以将.erl模块、依赖项和运行逻辑整合成跨平台的可执行脚本，就像Python的PyInstaller或Java的jar包那样便捷。

注意：escript生成的二进制文件仍需要对应版本的Erlang运行时，但不需要用户手动配置环境变量和依赖路径

2. 环境准备与基础配置

2.1 开发环境要求

• Erlang/OTP 21+（推荐26.2.5最新稳定版）
• rebar3构建工具
• 文本编辑器（VS Code/IntelliJ IDEA等）

验证环境：

erl -version rebar3 --version

2.2 项目结构示例

myapp/ ├── src/ │ ├── myapp_app.erl │ ├── myapp_sup.erl │ └── myapp_main.erl ├── priv/ │ └── config.json └── rebar.config

3. 多模块打包实战

3.1 rebar.config关键配置

{escript_incl_apps, [myapp, crypto]}. {escript_main_app, myapp}. {escript_name, "myapp"}. {escript_emu_args, "%%! +sbtu +A0\n"}.

参数说明：

• escript_incl_apps：包含的OTP应用
• escript_main_app：主应用模块
• escript_emu_args：运行时参数（此处禁用tty驱动）

3.2 入口模块编写

-module(myapp_main). -mode(compile). main(_Args) -> io:format("Running with ~p~n", [erlang:system_info(otp_release)]), myapp_app:start().

关键点：必须包含-compile属性且实现main/1函数

4. 构建与调试技巧

4.1 构建命令

rebar3 escriptize

生成文件位于：_build/default/bin/myapp

4.2 常见问题处理

4.2.1 模块加载失败

症状：

module 'myapp_app' not found

解决方案：

1. 检查rebar.config的escript_incl_apps
2. 确认模块已编译到_build/default/lib/

4.2.2 资源文件读取异常

当需要读取priv目录时：

read_priv_file(Filename) -> Path = filename:join([code:priv_dir(myapp), Filename]), {ok, Bin} = file:read_file(Path).

5. 高级应用场景

5.1 静态资源打包

修改rebar.config：

{overrides, [{override, myapp, [{extra_src_dirs, ["assets"]}]}]}.

5.2 跨平台注意事项

Windows系统需处理：

• 换行符（建议统一使用LF）
• 路径分隔符（使用filename:join/1）

6. 性能优化方案

6.1 预编译BEAM文件

{escript_embedding, beam}.

6.2 压缩选项

{escript_compress, best}.

实测对比：

7. 安全加固措施

7.1 代码混淆

{plugins, [rebar3_obfuscate]}. {obfuscate, [{app, myapp}]}.

7.2 签名验证

openssl dgst -sha256 myapp

8. 实际案例演示

电商订单处理系统打包流程：

1. 包含的模块：
   • order_processor
   • payment_gateway
   • inventory_service
2. 特殊处理：

   {escript_emu_args, "%%! -env ERL_LIBS _build/default/lib\n"}.

3. 启动参数解析：

   main(Args) -> case parse_args(Args) of {ok, Opts} -> order_processor:start(Opts); error -> halt(1) end.

9. 替代方案对比

10. 扩展应用方向

10.1 与Web框架集成

配合Cowboy构建自包含HTTP服务：

main(_) -> Dispatch = cowboy_router:compile([{'_', [{"/", hello_handler, []}]}]), cowboy:start_clear(http, [{port, 8080}], #{env => #{dispatch => Dispatch}}).

10.2 嵌入式系统应用

在树莓派等设备上的部署要点：

1. 交叉编译ARM版本
2. 精简ERTS：

   {escript_emu_args, "%%! -boot start_clean\n"}.

我在实际项目中发现，当包含超过20个模块时，建议：

1. 使用-S模式运行避免模块加载冲突
2. 预热常用模块减少首次调用延迟
3. 监控内存使用防止BEAM堆溢出