当前位置：首页 > news >正文

记一次 TanStack Start 部署报 GLIBC_2.32 not found（依赖问题） - Higurashi

news 2026/6/24 2:17:56

背景

项目是TanStack Start + Vite，原本在服务器通过下面命令启动：

npx wrangler dev --config dist/server/wrangler.json --ip 127.0.0.1 --port 3000 --local

服务器环境是Ubuntu 20.04。

现象

启动时报错：

[ERROR] write EPIPE
/node_modules/@cloudflare/workerd-linux-64/bin/workerd: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.32' not found
/node_modules/@cloudflare/workerd-linux-64/bin/workerd: ... `GLIBC_2.33' not found
/node_modules/@cloudflare/workerd-linux-64/bin/workerd: ... `GLIBC_2.34' not found
/node_modules/@cloudflare/workerd-linux-64/bin/workerd: ... `GLIBC_2.35' not found

注意：EPIPE只是连带错误，真正导致失败的是glibc版本不满足。

根因分析

wrangler dev会拉起本地workerd。

当前服务器glibc=2.31，而workerd需要更高版本（至少 2.32+），因此二进制无法启动。

可用命令确认环境：

ldd --version | head -n 1
cat /etc/os-release

解决方案（本次采用）

不再在生产机使用wrangler dev，改为Node + vite preview运行 SSR。

1）修改`vite.config.ts`

import { defineConfig } from "@lovable.dev/vite-tanstack-config";export default defineConfig({cloudflare: false,vite: {preview: {allowedHosts: ["site.example.cn", "www.site.example.cn", "127.0.0.1", "localhost"],},},
});

说明：

cloudflare: false：避免构建依赖workerd。
allowedHosts：避免反代后出现Blocked request. This host is not allowed.。

2）启动脚本`start.sh`

#!/usr/bin/env bash
set -euo pipefailAPP_DIR="/www/wwwroot/site.example.cn.source"
PORT="${PORT:-3000}"
LOG_DIR="$APP_DIR/logs"
PID_FILE="$APP_DIR/app.pid"cd "$APP_DIR"
mkdir -p "$LOG_DIR"export NODE_ENV=production
export CI=1if [ -f "$PID_FILE" ] && kill -0 "$(cat "$PID_FILE")" 2>/dev/null; thenkill "$(cat "$PID_FILE")" || truesleep 1
fipkill -f "wrangler dev" || true
pkill -f "vite preview" || trueif [ ! -d node_modules ]; thennpm ci
finpm run build
nohup npm run preview -- --host 127.0.0.1 --port "$PORT" > "$LOG_DIR/app.out.log" 2>&1 &
echo $! > "$PID_FILE"

3）Nginx 反向代理

location ^~ / {proxy_pass http://127.0.0.1:3000;proxy_http_version 1.1;proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;proxy_set_header X-Forwarded-Proto $scheme;proxy_read_timeout 60s;
}

发布与验证

cd /www/wwwroot/site.example.cn.source
./start.sh
ss -lntp | grep :3000
tail -n 100 /www/wwwroot/site.example.cn.source/logs/app.out.log
curl -k -I https://site.example.cn

预期：