Alpine容器中Gramex 1.91.1的ESBUILD构建失败求助

环境信息 #

$ cat /etc/os-release 
NAME="Alpine Linux"
ID=alpine
VERSION_ID=3.17.1
PRETTY_NAME="Alpine Linux v3.17"
HOME_URL="https://alpinelinux.org/"
BUG_REPORT_URL="https://gitlab.alpinelinux.org/alpine/aports/-/issues"
$
$ gramex --version
Gramex version: 1.91.1
Gramex path: /home/gramex/conda/lib/python3.9/site-packages/gramex
Python version: 3.9.16
Python path: /home/gramex/conda/bin/python
$
$ node --version
v16.19.1
$ npm --version
8.10.0

问题场景 #

有一个TypeScript文件/app/ts/index.ts，在Gramex服务器中构建失败，手动执行底层构建命令时同样报错：

执行的命令 #

cd /app/ts
node /home/gramex/conda/lib/python3.9/site-packages/gramex/apps/ui/node_modules/esbuild/bin/esbuild --format=esm --bundle =true --minify=false --target=esnext --charset=utf8 --global-name= --keep-names=false --allow-overwrite --sourcemap --outdir=/home/gramex/.config/gramexdata/apps/ui/.ts-51554 index.ts

报错信息 #

/home/gramex/conda/lib/python3.9/site-packages/gramex/apps/ui/node_modules/esbuild/bin/esbuild:1
ELF
^

SyntaxError: Invalid or unexpected token
    at Object.compileFunction (node:vm:360:18)
    at wrapSafe (node:internal/modules/cjs/loader:1119:15)
    at Module._compile (node:internal/modules/cjs/loader:1155:27)
    at Object.Module._extensions..js (node:internal/modules/cjs/loader:1245:10)
    at Module.load (node:internal/modules/cjs/loader:1069:32)
    at Function.Module._load (node:internal/modules/cjs/loader:904:12)
    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:81:12)
    at node:internal/main/run_main_module:22:47

已尝试在UI目录重新安装esbuild，问题仍未解决。

核心原因 #

1. 你用node命令执行了esbuild的二进制可执行文件，但esbuild二进制不是Node.js脚本，Node.js无法解析ELF格式的二进制内容，因此抛出语法错误。
2. 原命令中--bundle =true的空格会导致参数解析异常。
3. Alpine使用musl libc，默认npm安装的esbuild基于glibc编译，存在兼容性问题。

修复步骤 #

1. 修正执行命令 #

直接运行esbuild二进制文件，去掉node前缀，并修复参数格式（删除--bundle与=true之间的空格）：

cd /app/ts
/home/gramex/conda/lib/python3.9/site-packages/gramex/apps/ui/node_modules/esbuild/bin/esbuild --format=esm --bundle=true --minify=false --target=esnext --charset=utf8 --global-name= --keep-names=false --allow-overwrite --sourcemap --outdir=/home/gramex/.config/gramexdata/apps/ui/.ts-51554 index.ts

2. 解决musl兼容性问题 #

如果直接执行二进制仍报错（如exec format error或依赖缺失），重新安装适配musl的esbuild版本：

• 卸载现有esbuild：

  cd /home/gramex/conda/lib/python3.9/site-packages/gramex/apps/ui
  npm uninstall esbuild
  

• 安装musl兼容版本：

  npm install esbuild@0.17.19 --force --platform=linux --arch=x64 --libc=musl
  

3. 验证修复 #

执行以下命令确认esbuild可正常运行：

/home/gramex/conda/lib/python3.9/site-packages/gramex/apps/ui/node_modules/esbuild/bin/esbuild --version

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