.NET MAUI项目安装Plugin.Firebase.CloudMessaging遇路径过长错误

一、解决路径过长问题的特定方法 #

• 临时屏蔽iOS项目的NuGet恢复：打开MAUI项目的.csproj文件，找到iOS对应的<PropertyGroup>节点，添加<RestorePackages>false</RestorePackages>。安装完包后如果需要iOS支持，再改回true，这能避免处理iOS依赖带来的深层路径。
• 缩短NuGet缓存路径：编辑%APPDATA%\NuGet\NuGet.Config，添加如下配置，把缓存目录改成短路径（比如C:\NuCache）：

  <configuration>
    <config>
      <add key="globalPackagesFolder" value="C:\NuCache" />
    </config>
  </configuration>
  

• 用符号链接简化项目路径：打开管理员权限的命令提示符，执行mklink /D C:\ShortPath "你的项目实际长路径"，之后通过C:\ShortPath打开项目操作，减少路径层级。

二、关于Plugin.Firebase.CloudMessaging与MAUI的兼容性 #

该插件官方支持MAUI，但部分版本在处理跨平台依赖时会生成超长路径，属于依赖打包的问题而非核心兼容性问题。建议：

• 安装最新稳定版插件，查看其GitHub仓库的release日志，确认标注支持当前MAUI SDK版本的包；
• 如果最新版仍有问题，尝试降级到前几个稳定版本（比如2.0.x系列），部分旧版本的依赖结构更简洁，路径更短。

三、无需依赖该插件的FCM集成替代方案 #

• 直接调用Firebase REST API：客户端通过MAUI平台特定代码实现令牌获取（Android端调用FirebaseMessaging.Instance.GetTokenAsync()），后端使用FCM的REST API发送推送消息，完全绕过第三方插件。
• 手动集成Android Firebase SDK：在MAUI Android项目中添加google-services.json配置文件，在Android项目的.csproj中直接引用Firebase Messaging的Maven依赖，然后通过平台特定代码实现初始化、消息接收逻辑，不依赖NuGet插件。

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