Apple Silicon Mac用PeachPie运行WordPress遇MonoPosixHelper加载失败

问题描述 #

在搭载Apple Silicon芯片的Mac上，通过PeachPie编译器运行WordPress项目，执行dotnet run命令后，浏览器中抛出以下错误：

System.DllNotFoundException: Unable to load shared library 'MonoPosixHelper' or one of its dependencies. In order to help diagnose loading problems, consider setting the DYLD_PRINT_LIBRARIES environment variable: dlopen(libMonoPosixHelper, 0x0001): tried: 'libMonoPosixHelper' (no such file), '/System/Volumes/Preboot/Cryptexes/OSlibMonoPosixHelper' (no such file), '/usr/lib/libMonoPosixHelper' (no such file, not in dyld cache), 'libMonoPosixHelper' (no such file), '/usr/local/lib/libMonoPosixHelper' (no such file), '/usr/lib/libMonoPosixHelper' (no such file, not in dyld cache)
at Peachpie.AspNetCore.Web.PhpHandlerMiddleware.InvokeScriptAsync(HttpContext context, ScriptInfo script, String path_info)
at PeachPied.WordPress.AspNetCore.Internal.WpResponseCacheMiddleware.CaptureResponse(HttpContext context)
at PeachPied.WordPress.AspNetCore.Internal.WpResponseCacheMiddleware.Invoke(HttpContext context)
at PeachPied.WordPress.AspNetCore.Internal.DiagnosticExtensions.Middleware.Invoke(HttpContext context)
at Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddleware.Invoke(HttpContext context)

解决方案 #

1. 强制通过Rosetta 2运行dotnet #

利用Apple Silicon的Rosetta 2模拟x64架构环境，解决ARM架构下的库兼容性问题：

• 临时运行：在终端执行

  arch -x86_64 dotnet run
  

• 长期生效：打开终端应用，右键选择「显示简介」，勾选「使用Rosetta打开」，重启终端后直接执行dotnet run。

2. 更新PeachPie相关NuGet包至最新版 #

新版本的PeachPie已针对Apple Silicon做兼容性优化，更新包可直接解决问题：

• 终端执行命令更新核心包：

  dotnet add package PeachPied.WordPress.AspNetCore --version *
  

• 或手动编辑项目的.csproj文件，将PeachPie相关包的版本号替换为最新稳定版。

3. 强制指定x64运行时架构 #

在项目配置中明确指定x64架构，避免ARM运行时的加载问题：

1. 打开项目的.csproj文件，添加以下配置：

   <PropertyGroup>
     <RuntimeIdentifier>osx-x64</RuntimeIdentifier>
   </PropertyGroup>
   

2. 清理并重新构建项目：

   dotnet clean
   dotnet build
   dotnet run
   

原因说明 #

MonoPosixHelper是依赖x64架构的系统库，早期版本的PeachPie未完全适配Apple Silicon的ARM64架构，导致运行时无法找到对应库文件。通过Rosetta模拟x64环境、更新兼容包或指定x64运行时，均可解决该加载失败问题。

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