使用Express与Supabase Edge Functions时遭遇404路由问题求助

核心问题分析 #

Supabase Edge Functions的请求处理逻辑和标准Node.js环境存在差异，文档默认你理解路径前缀的处理规则，但这恰恰是最容易遗漏的点——必须手动移除请求URL中的函数名称前缀，才能让Express正确解析路由。

具体修复方案 #

1. 修正Express入口的路径处理 #

修改你的函数入口文件（比如index.ts），在将请求传递给Express实例前，先去掉URL里的函数名称前缀：

import { serve } from 'https://deno.land/std@0.177.0/http/server.ts'
import express from 'npm:express@4.18.2'

const app = express()

// 保留你原有的路由配置
app.get('/hello', (req, res) => {
  res.send('Hello from Express!')
})

// 关键：处理请求路径，移除函数名称前缀
serve(async (req) => {
  const url = new URL(req.url)
  // 替换成你的Edge Function实际名称，比如创建时用的`supabase functions create express-test`就填`express-test`
  const cleanedPath = url.pathname.replace(/^\/express-test/, '')
  // 构造新的请求对象，让Express能识别正确的路由
  const modifiedReq = new Request(`${url.origin}${cleanedPath}`, req)
  
  return app(modifiedReq)
})

2. 本地测试时的请求路径要正确 #

本地运行函数后，请求URL必须包含函数名称，比如你的函数名叫express-test，正确的请求地址是：

http://localhost:54321/functions/v1/express-test/hello

而非直接访问http://localhost:54321/functions/v1/hello

3. 核对Deno版本兼容性 #

确保本地Deno版本和Supabase Edge Functions运行环境一致（推荐1.35.0及以上），版本不匹配可能导致路由解析异常：

deno --version
# 版本过低的话执行升级
deno upgrade

4. 部署后验证日志 #

进入Supabase控制台的Edge Functions页面，查看函数的请求日志，确认实际传入的req.url格式，检查路径是否被正确清理。

其他框架的通用处理逻辑 #

不管用Koa、Hono还是其他框架，核心思路都是一致的：

• 将框架实例挂载到根路径
• 处理请求时移除URL中的函数名称前缀
• 确保框架能正确接收Deno的Request对象

比如Hono的示例：

import { serve } from 'https://deno.land/std@0.177.0/http/server.ts'
import { Hono } from 'https://deno.land/x/hono@v3.2.0/mod.ts'

const app = new Hono()

app.get('/hello', (c) => c.text('Hello from Hono!'))

serve(async (req) => {
  const url = new URL(req.url)
  const cleanedPath = url.pathname.replace(/^\/hono-test/, '')
  return app.fetch(new Request(`${url.origin}${cleanedPath}`, req))
})

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