在Next.js API路由中使用child_process.exec执行Shell命令（如curl）时，需通过Promise封装并await获取stdout/stderr，避免回调函数内return失效的问题；本文详解异步改造、正则提取与错误处理全流程。
在next.js api路由中使用`child_process.exec`执行shell命令（如curl）时，需通过promise封装并`await`获取stdout/stderr，避免回调函数内`return`失效的问题；本文详解异步改造、正则提取与错误处理全流程。
在Next.js服务端API路由中调用系统命令（例如curl -s -v抓取HTTP响应头）是常见需求，但直接使用Node.js原生child_process.exec的回调模式极易踩坑——正如问题所示：在回调函数中return final，并不会将值返回给外层逻辑，因为exec()本身同步返回的是ChildProcess实例，而非执行结果；而回调中的return仅终止该回调函数，对上层作用域无影响。
✅ 正确解法是：将exec Promise化，并在async/await上下文中处理结果。自Node.js 15.0起，child_process已内置exec的Promise版本（位于child_process/promises），推荐优先使用：
// pages/api/extract-session.ts (Next.js Pages Router)
import { exec } from 'child_process/promises';
export default async function handler(req, res) {
try {
// ✅ 使用 Promise 版本，直接 await 获取结构化输出
const { stdout, stderr } = await exec('curl -s -v https://test.com/index.php');
// 解析 stderr（curl -v 将响应头输出到 stderr）
const lines = stderr.split('\n');
const sessionRegex = /Set-Cookie:\s+SESSIDe08a=([^\s;]+)/i;
let sessionId: string | null = null;
for (const line of lines) {
const match = sessionRegex.exec(line);
if (match && match[1]) {
sessionId = match[1];
break;
}
}
if (!sessionId) {
return res.status(404).json({ error: 'SESSIDe08a not found in response headers' });
}
res.status(200).json({ sessionId });
} catch (err) {
console.error('[API] Session extraction failed:', err);
res.status(500).json({ error: 'Internal server error' });
}
}? 关键要点说明：
-
不要用
process.exit(1)：在Next.js API路由中调用process.exit()会强制终止整个Serverless函数或开发服务器进程，导致服务不可用。应始终使用res.status().json()返回HTTP错误响应。 -
正则优化建议：原正则
/Set\-Cookie:\ SESSIDe08a=[0-9A-Za-z]*;\ /i存在冗余且易误匹配；改用/Set-Cookie:\s+SESSIDe08a=([^\s;]+)/i更健壮——\s+匹配任意空白符，([^\s;]+)精准捕获SESSIDe08a=后首个分号或空格前的内容，避免后续replace链式操作出错。 -
超时与安全防护：生产环境务必添加超时和输入校验：
const { stdout, stderr } = await exec('curl -s -v --max-time 5 https://test.com/index.php', { timeout: 6000, // ms }); -
替代方案（推荐用于复杂场景）：若需更高可控性（如流式处理、实时日志），可结合
spawn+Readable流，但对简单Header提取而言，execPromise版已足够简洁高效。
⚠️ 注意事项：
- Next.js App Router用户请使用
app/api/xxx/route.ts格式，并确保runtime: 'nodejs'（默认即为Node.js运行时）； - 避免在客户端组件中调用此类服务端命令——
exec仅限服务端执行； - 若部署在Vercel等Serverless平台，请确认目标域名允许出站请求，且
curl二进制已预装（Vercel默认支持）。
掌握这一模式，你不仅能稳定提取Set-Cookie中的Session ID，还可扩展至解析任意Shell命令输出（如git log、ls -la、df -h等），为Next.js构建强大、安全的服务端集成能力打下坚实基础。
