在Fable应用中使用SwaggerProvider报错，求原因及API消费方案

我尝试在Fable应用中使用SwaggerProvider，项目配置及代码如下：

项目配置（.fsproj） #

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>netstandard2.0</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <Compile Include="App.fs" />
  </ItemGroup>
  <ItemGroup>
    <PackageReference Include="Fable.Browser.Dom" Version="2.2.0" />
    <PackageReference Include="Fable.Core" Version="3.2.3" />
    <PackageReference Include="SwaggerProvider" Version="1.0.1" />
  </ItemGroup>
</Project>

App.fs代码 #

// 代码参考自SwaggerProvider官方示例
module App

open Browser.Dom
open SwaggerProvider

let [<Literal>] Schema = "https://petstore.swagger.io/v2/swagger.json"
type PetStore = OpenApiClientProvider<Schema>

// 获取按钮元素并转换为HTMLButtonElement
let myButton = document.querySelector(".my-button") :?> Browser.Types.HTMLButtonElement

// 注册点击事件监听
myButton.onclick <- fun _ ->
    let client = PetStore.Client()

    let s = 
        client.GetInventory()
        |> Async.AwaitTask
        |> Async.RunSynchronously
        |> sprintf "%O"

    myButton.innerText <- s

Visual Studio Code的智能提示正常，说明设计阶段无问题，但执行npm start启动项目时出现以下错误：

错误信息 #

C:/Root/Work/Horth/Work/Yatp/Client/Fable/src/App.fs(7,17): (7,46) error FSHARP: The type provider 'SwaggerProvider.OpenApiClientTypeProvider' reported an error: Could not load file or assembly 'System.Text.Json, Version=6.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51'. Could not find or load a specific file. (0x80131621) (code 3033)
C:/Root/Work/Horth/Work/Yatp/Client/Fable/src/App.fs(17,27): (17,33) error FSHARP: The type 'PetStore' does not define the field, constructor or member 'Client'. (code 39)

问题 #

1. 我哪里操作有误？
2. 若Fable不支持该类型提供器，在Fable应用中消费OpenAPI/Swagger REST API的推荐方式是什么？

问题分析与解答 #

操作错误原因

SwaggerProvider是基于.NET平台的类型提供器，这类工具依赖.NET运行时在编译阶段动态生成类型。而Fable的核心是将F#代码编译为JavaScript，运行在浏览器/Node.js环境，无法直接调用依赖.NET框架的类型提供器。

你看到的第一个错误是因为SwaggerProvider依赖的System.Text.Json 6.0.0.0与你的项目目标框架netstandard2.0不兼容；第二个错误是因为类型提供器未能正常生成PetStore相关类型，导致代码中找不到Client成员。

推荐的替代方案

• 提前生成兼容Fable的客户端代码
  使用OpenAPI Generator等工具，根据Swagger Schema提前生成纯F#客户端代码（无类型提供器依赖）。生成的代码可以直接导入Fable项目，调用方式和普通F#函数一致，同时保留完整的类型安全。
• 手写类型安全的HTTP请求
  使用Fable生态的Fable.Fetch库，手动定义API的请求参数类型和响应数据类型，通过fetch发送请求，配合Thoth.Json或Fable.Core.JS.JSON处理序列化/反序列化。这种方式灵活可控，适合API规模较小的场景。
• 结合Thoth.Json简化序列化
  Thoth.Json提供自动编码器/解码器功能，能根据F#类型自动生成序列化逻辑，减少手动编写序列化代码的工作量，同时保持类型安全。

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