Go生成的DLL在PHP FFI加载时出现initial-exec TLS重定位错误

问题原因 #

Alpine Linux采用musl libc，Go 1.21编译c-shared模式的共享库时，默认TLS（线程局部存储）模型与musl的动态链接机制不兼容，触发runtime.tlsg: initial-exec TLS resolves to dynamic definition重定位错误。

解决方法 #

• 调整Go编译参数，适配musl的TLS规则
  编译时强制使用外部链接器，并指定全局动态TLS模型，执行以下命令：

  go build -o project.dll -buildmode=c-shared -ldflags="-linkmode=external -extldflags='-Wl,-z,now,-z,relro,-z,defs,-ftls-model=global-dynamic'" ./cmd/main.go
  

  其中：

  • -linkmode=external：强制调用系统外部链接器替代Go内置链接器
  • -ftls-model=global-dynamic：让gcc链接器使用全局动态TLS模型，适配musl的动态链接逻辑

• 确保Go编译环境依赖完整
  在golang:1.21-alpine3.20容器中先安装gcc和musl-dev，保证外部链接器正常工作：

  apk add gcc musl-dev
  

• 优化PHP FFI加载方式
  加载共享库时使用延迟加载标志，降低TLS冲突概率：

  <?php
  $ffi = FFI::cdef(
      "void your_exported_function();",
      __DIR__ . "/../../project.dll",
      FFI::LOAD_LAZY
  );
  $ffi->your_exported_function();
  ?>
  

内容的提问来源于stack exchange，提问作者Hamid Raza Noori