如何在xlwings Server中实现服务器端计算的自定义函数？

一、后端FastAPI接口规范实现 #

把参数传递从headers改为请求体，这是REST接口的标准做法，同时避免headers的长度限制问题：

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

# 定义请求体模型，自动校验参数类型
class CalcRequest(BaseModel):
    val1: int
    val2: int

@app.post("/calc/add")
def add_numbers(req: CalcRequest):
    # 此处替换为你的业务逻辑
    return {"result": req.val1 + req.val2}

二、前端VBA UDF正确写法（无需修改xlwings源码） #

利用xlwings自带的RunRemotePython返回的JSON解析对象，直接提取result字段即可，无需改动xlwings源码：

Function ServerAdd(val1 As Integer, val2 As Integer) As Variant
    ' 标记函数为非易失性，仅当输入参数变化时触发重计算（解决循环引用警告）
    Application.Volatile False
    
    Dim payload As String
    ' 构造符合JSON格式的请求体
    payload = "{""val1"": " & val1 & ", ""val2"": " & val2 & "}"
    
    Dim response As Variant
    On Error GoTo ErrorHandler ' 捕获请求失败的情况
    
    ' 调用远程接口，指定POST方法、请求体和Content-Type头
    Set response = RunRemotePython( _
        url:="http://127.0.0.1:8000/calc/add", _
        method:="POST", _
        body:=payload, _
        headers:=CreateObject("Scripting.Dictionary"), _
        exclude:="xlwings.conf" _
    )
    ' 添加Content-Type头，确保后端能正确解析JSON
    response.headers.Add "Content-Type", "application/json"
    
    ' 从响应字典中提取结果
    ServerAdd = response("result")
    Exit Function
    
ErrorHandler:
    ' 请求失败时返回Excel错误值，避免弹窗报错
    ServerAdd = CVErr(xlErrValue)
End Function

三、解决循环引用警告的关键 #

循环引用的核心原因是Excel默认认为自定义函数是易失性的（会频繁触发重计算），加上Application.Volatile False后，Excel只会在val1或val2变化时才重新计算该函数，彻底避免无意义的循环触发。

四、批量部署，无需逐个更新Excel #

如果要给数十个Excel文件共用这个UDF，不用逐个修改VBA：

1. 将上述VBA代码保存为Excel加载项（.xlam格式）
2. 让终端用户安装这个加载项（Excel选项→加载项→管理Excel加载项→浏览选择文件）
3. 后续后端逻辑更新时，前端Excel无需做任何修改，直接生效

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