本地Supabase Edge Function无法在终端打印console.log日志

云上老周

2026-6-15

解决Supabase Edge Function中console.log不输出日志的问题

针对你遇到的console.log无法在终端输出的情况，可按以下步骤排查：

检查本地运行命令的日志级别参数
运行Supabase Edge Function时，需要显式指定日志级别才能捕获函数内的console输出。确保使用带日志级别的命令启动：
```
supabase functions serve <你的函数名> --log-level info
```
可选的日志级别包括debug、info、warn、error，使用debug能获取最详细的输出。
确认请求路径是否匹配中间件
你的中间件监听/api/*路径，但本地调用Edge Function的完整路径格式为http://localhost:54321/functions/v1/<函数名>/api/xxx。如果请求时遗漏了/api前缀，或者路径匹配错误，中间件不会触发，自然不会输出日志。可以先在代码最顶部添加全局日志测试：
```
console.log("函数已启动");
import "jsr:@supabase/functions-js/edge-runtime.d.ts";
// ... 其余代码
```
启动函数后看是否能输出这条日志，排除代码未执行的问题。
尝试用Deno原生输出替代console.log
部分情况下，Edge Runtime的console.log可能存在适配问题，可改用Deno原生输出方式测试：
```
await Deno.stdout.write(new TextEncoder().encode("TESTING\n"));
```
如果这种方式能输出，说明需要调整Deno的运行配置，可在supabase/functions/<函数名>/func.yaml中添加Deno参数：
```
deno_options:
  log_level: info
```
查看Docker容器日志
Supabase本地服务依赖Docker运行，函数的日志可能输出到容器内部而非终端。先通过docker ps找到Edge Runtime对应的容器（通常名为supabase_edge_runtime），然后执行：
```
docker logs -f supabase_edge_runtime
```
查看容器日志中是否存在你的console.log内容。
检查环境变量配置
确保SUPABASE_LOG_LEVEL环境变量已设置为info或更高级别，可在启动前执行：
```
export SUPABASE_LOG_LEVEL=debug
```
再启动函数服务。