Azure Functions V4（TypeScript）路由参数异常：数字参数无法读取

问题场景 #

路由设置为test/{parameter}，当传入字符串参数（如/api/test/test）时，request.params能正常拿到{"parameter":"test"}；但传入数字参数（如/api/test/1）时，request.params是空对象。

解决步骤 #

1. 升级@azure/functions版本 #

v4.0.0版本存在路由参数解析的已知bug，对数字类型参数处理异常。直接升级到最新稳定版：

npm install @azure/functions@latest

2. 给路由参数添加类型约束 #

在路由配置里明确参数的类型约束，匹配不同类型的参数：

• 若只需要匹配整数，使用int约束：

app.http('test', {
    methods: ['GET', 'POST'],
    authLevel: 'anonymous',
    handler: RenderFiles,
    route: 'test/{parameter:int}'
});

• 若需要支持任意类型（字符串、数字均可），使用any约束：

route: 'test/{parameter:any}'

注意：无论原参数是数字还是字符串，request.params返回的都是字符串类型，如需数字类型需自行转换。

3. 检查TypeScript编译配置 #

确保tsconfig.json的配置符合Azure Functions V4要求，参考配置如下：

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true
  }
}

4. 更新Azure Functions Core Tools #

运行时版本与SDK不兼容也可能引发此类问题，检查并升级Core Tools：

# 查看当前版本
func --version
# 升级到v4最新版
npm install -g azure-functions-core-tools@4

验证操作 #

修改完成后，重新构建并启动函数：

npm run build && npm start

再次调用/api/test/1，此时request.params应正常返回{"parameter":"1"}。

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