前端融入/转后端避坑指南:AI 时代的安全边界、数据防线与实战细节

文章目录

    • 一、先建立后端思维:前端是体验层,后端是安全边界
    • 二、安全边界:永远不要信任客户端
      • [2.1 身份必须来自服务端可信来源](#2.1 身份必须来自服务端可信来源)
      • [2.2 水平越权:只看 ID 是不够的](#2.2 水平越权:只看 ID 是不够的)
      • [2.3 Next.js Server Actions 也不是"天然安全"](#2.3 Next.js Server Actions 也不是“天然安全”)
      • [2.4 CORS 不要简单配置成 *](#2.4 CORS 不要简单配置成 *)
    • 三、数据安全:输入、存储、返回都要受控
      • [3.1 所有输入都不可信](#3.1 所有输入都不可信)
      • [3.2 SQL / NoSQL 注入](#3.2 SQL / NoSQL 注入)
      • [3.3 敏感数据不要原样返回](#3.3 敏感数据不要原样返回)
      • [3.4 密钥管理:不要把 Secret 写进代码](#3.4 密钥管理:不要把 Secret 写进代码)
    • 四、并发与一致性:后端不能只按单用户调试
      • [4.1 积分/余额扣减不能先查后改](#4.1 积分/余额扣减不能先查后改)
      • [4.2 写接口要考虑幂等性](#4.2 写接口要考虑幂等性)
      • [4.3 限流不只是"防止服务器崩"](#4.3 限流不只是“防止服务器崩”)
    • 五、错误处理:不要向客户端泄露内部信息
    • 六、文件、路径与命令执行
      • [6.1 文件上传要限制类型、大小和存储路径](#6.1 文件上传要限制类型、大小和存储路径)
      • [6.2 路径遍历](#6.2 路径遍历)
      • [6.3 命令执行](#6.3 命令执行)
    • 七、依赖与运行时安全:不要只关注业务代码
      • [7.1 锁定依赖版本](#7.1 锁定依赖版本)
      • [7.2 定期扫描依赖漏洞](#7.2 定期扫描依赖漏洞)
      • [7.3 关注运行时安全更新](#7.3 关注运行时安全更新)
    • [八、AI 辅助编程:效率提升,但风险也前置了](#八、AI 辅助编程:效率提升,但风险也前置了)
      • [8.1 不要把代码库原样喂给 AI](#8.1 不要把代码库原样喂给 AI)
      • [8.2 AI 生成的后端代码要按"外部贡献"审查](#8.2 AI 生成的后端代码要按“外部贡献”审查)
      • [8.3 用规则约束 AI,而不是只靠人工记忆](#8.3 用规则约束 AI,而不是只靠人工记忆)
    • 九、上线前快速自查
    • 总结

相信很多前端小伙伴近期也看到了很多新闻,以及自身感受到了一个变化:前端工程师也都开始写后端代码了,这种现象越来越常见了。比如:Next.js Server Actions、BFF 层、Node.js 中间层、云函数、Supabase/Prisma 数据访问,甚至不少同学也开始接触 Spring Boot 等 Java 后端框架,直接编写 SQL 查询、设计数据库表结构。

这些技术栈让原本只负责"页面和交互"的人,直接接触到认证、授权、数据库、第三方 API、密钥和线上运维。

但后端真正的难点从来不只是"写几个接口、查几张表",而是要把数据流、权限边界、并发一致性、错误处理、密钥管理、依赖安全全部纳入生产级约束。

那作为对后端技术相对不那么了解的人来说,该怎么去更好的接纳以及融入后端环境里呢?

一、先建立后端思维:前端是体验层,后端是安全边界

前端工程师最容易带过去的惯性是:把校验放在用户看得到的地方~

场景 前端思维 后端思维
表单校验 必填、长度、正则都做了 所有输入仍要在后端重新校验
按钮权限 没有权限就隐藏按钮 接口必须重新判断身份和权限
删除数据 前端传 isAdmin: true 身份必须来自可信来源,如 JWT/Session
错误提示 把报错直接展示 后端返回通用错误,细节写入服务端日志
数据返回 直接返回整个对象 只返回前端真正需要的字段

前端校验仍然有价值,但它只能提升体验;任何安全判断都必须由后端完成。

二、安全边界:永远不要信任客户端

2.1 身份必须来自服务端可信来源

下面是一个常见的错误写法:

typescript 复制代码
//  危险:信任前端传来的身份字段
app.post('/api/users/delete', async (req, res) => {
	if (req.body.isAdmin) {
	  await db.users.delete({ where: { id: req.body.targetId } });
	}
});

攻击者只要修改请求体,就可以伪造管理员身份。

正确做法是从服务端校验后的会话、Token 或 Session 中获取身份:

typescript 复制代码
//  正确:身份来自服务端可信来源
app.post('/api/users/delete', async (req, res) => {
const session = await getSession(req);
if (!session?.userId) {
return res.status(401).json({ error: '未登录' });
}
if (!session.isAdmin) {
return res.status(403).json({ error: '权限不足' });
}
await db.users.delete({ where: { id: req.body.targetId } });
return res.json({ ok: true });
});

2.2 水平越权:只看 ID 是不够的

很多接口会这样写:

typescript 复制代码
//  危险:只校验登录,不校验资源归属
app.get('/api/orders/:id', async (req, res) => {
const order = await db.orders.findUnique({
where: { id: req.params.id },
});
return res.json(order);
});

如果攻击者把 id 换成别人的订单 ID,就可能直接读取他人数据。

应改为:

typescript 复制代码
//  正确:校验资源是否属于当前用户
app.get('/api/orders/:id', async (req, res) => {
const session = await getSession(req);
const order = await db.orders.findUnique({
where: {
id: req.params.id,
userId: session.userId,
},
});
if (!order) {
return res.status(404).json({ error: '订单不存在' });
}
return res.json(order);
});

垂直越权也要单独判断。例如普通用户不能调用 /api/admin/stats,管理员也不能绕过业务规则直接修改敏感字段。

2.3 Next.js Server Actions 也不是"天然安全"

Server Actions 虽然写在应用代码里,但它本质上仍然是服务端入口。

typescript 复制代码
//  危险:没有鉴权
'use server';
export async function deletePost(id: string) {
await db.posts.delete({ where: { id } });
}
//  正确:先鉴权,再校验归属
'use server';
export async function deletePost(id: string) {
const session = await getSession();
if (!session?.userId) {
throw new Error('Unauthorized');
}
const post = await db.posts.findUnique({ where: { id } });
if (!post || post.authorId !== session.userId) {
throw new Error('Forbidden');
}
await db.posts.delete({ where: { id } });
}

Server Actions 不会自动帮你做登录校验,它只是把请求处理从传统 API 路由换成了函数调用。

2.4 CORS 不要简单配置成 *

AI 生成的代码里经常出现这种写法:

typescript 复制代码
//  危险:生产环境开放所有来源
app.use(
cors({
origin: '*',
credentials: true,
})
);

更稳妥的做法是显式白名单:

typescript 复制代码
//  正确:只允许已知前端域名
const ALLOWED_ORIGINS = [
'https://app.example.com',
'https://admin.example.com',
];
app.use(
cors({
	origin(origin, callback) {
	if (!origin || ALLOWED_ORIGINS.includes(origin)) {
	callback(null, true);
	} else {
	callback(new Error('Not allowed by CORS'));
	}
},
credentials: true,
})
);

如果接口不需要携带 Cookie 或 Authorization,可以不开 credentials;如果需要,就更不能随意放开 origin。

三、数据安全:输入、存储、返回都要受控

3.1 所有输入都不可信

后端收到的数据包括:

  • URL 参数:req.query
  • 请求体:req.body
  • Header:req.headers
  • Cookie:req.cookies
  • 文件上传
  • 第三方回调
  • 定时任务参数
  • 消息队列消息
typescript 复制代码
// 这些都不能假设"前端已经校验过了"。
import { z } from 'zod';
const CreateJobSchema = z.object({
title: z.string().min(3).max(200),
company: z.string().min(2).max(100),
salaryMin: z.number().int().min(0),
salaryMax: z.number().int().min(0),
});
app.post('/api/jobs', async (req, res) => {
const result = CreateJobSchema.safeParse(req.body);
if (!result.success) {
return res.status(400).json({ error: result.error.flatten() });
}
const job = await db.jobs.create({ data: result.data });
return res.status(201).json({ id: job.id });
});

使用 Zod、Valibot、Joi、Yup 这类库,可以把"校验逻辑"从业务代码里抽出来,也更容易在 Server Actions、API Route、云函数之间复用。

3.2 SQL / NoSQL 注入

错误写法:

typescript 复制代码
//  危险:字符串拼接 SQL
const sql = `SELECT * FROM users WHERE email = '${req.query.email}'`;

正确写法:

typescript 复制代码
//  正确:参数化查询
const row = await db.query(
'SELECT * FROM users WHERE email = $1',
[req.query.email]
);

ORM 也不能完全免疫注入。如果 ORM 允许传入原始 SQL,或者允许拼接 where 条件,仍然可能出问题。

typescript 复制代码
//  危险:ORM 中拼接原始条件
await db.user.findMany({
	where: {
		name: { contains: req.query.keyword },
	},
});

如果 keyword 被直接拼进底层查询,仍可能存在风险。更安全的做法是使用 ORM 提供的参数化能力,并对特殊字符、长度、类型做限制。

MongoDB 类数据库也要注意 NoSQL 注入。例如前端传入:

typescript 复制代码
{
	"username": { "$ne": null },
	"password": { "$ne": null }
}

如果后端直接把请求体传给查询条件,就可能绕过登录。应显式取字段并校验类型:

typescript 复制代码
const username = String(req.body.username ?? '');
const password = String(req.body.password ?? '');
const user = await db.users.findOne({ username, password });

3.3 敏感数据不要原样返回

typescript 复制代码
//  危险:返回完整用户对象
res.json(user);

user 里可能包含:

  • 密码哈希
  • 手机号
  • 身份证号
  • 邮箱
  • 内部角色标记
  • 第三方 Token
  • 审计字段
typescript 复制代码
应改为:
//  正确:只返回必要字段
res.json({
	id: user.id,
	nickname: user.nickname,
	avatar: user.avatar,
	role: user.role,
});

在 Next.js Server Components 中尤其要注意:如果查询结果会被序列化到客户端,多余字段就可能直接暴露。

3.4 密钥管理:不要把 Secret 写进代码

typescript 复制代码
//  危险:硬编码密钥
const AI_API_KEY = 'sk_live_xxx';
const DB_PASSWORD = 'prod_db_123';

正确做法:

typescript 复制代码
//  正确:从环境变量读取
const AI_API_KEY = process.env.AI_API_KEY;
const DB_PASSWORD = process.env.DB_PASSWORD;
if (!AI_API_KEY) {
	throw new Error('Missing AI_API_KEY');
}

同时注意:

  • .env 文件加入 .gitignore
  • 生产环境使用密钥管理服务,如 Vault、云厂商 KMS/Secrets Manager
  • 前端代码中不要暴露服务端密钥
  • Next.js 中 NEXT_PUBLIC_ 前缀的变量会暴露给浏览器,不能存放 Secret

四、并发与一致性:后端不能只按单用户调试

前端调试时通常只有一个用户、一个请求、一个浏览器标签。但后端要面对并发请求、重试、脚本刷接口、支付扣费、库存扣减、AI Token 计费等问题。

4.1 积分/余额扣减不能先查后改

typescript 复制代码
//  危险:非原子操作,并发下会超扣
const user = await User.findById(req.userId);
if (user.points < 1) {
	return res.status(403).json({ error: '积分不足' });
}
user.points -= 1;
await user.save();
await callAI();

如果两个请求同时进入,都可能读到 points = 1,于是两次都扣减成功,实际只该扣一次。

应改为原子操作:

typescript 复制代码
//  正确:数据库原子扣减
const result = await User.findOneAndUpdate(
{ _id: req.userId, points: { $gte: 1 } },
{ $inc: { points: -1 } },
{ new: true }
);
if (!result) {
	return res.status(403).json({ error: '积分不足' });
}
await callAI();

涉及余额、库存、次数、优惠券、AI Token 用量时,都要优先考虑原子更新、事务或分布式锁。

4.2 写接口要考虑幂等性

用户重复点击、网络重试、前端超时重发都很常见。

typescript 复制代码
//  幂等键示例
const idempotencyKey = req.headers['x-idempotency-key'];
if (idempotencyKey) {
const existing = await db.idempotencyKeys.findUnique({
	where: { key: idempotencyKey },
});
if (existing) {
	return res.json(existing.response);
}
}
const response = await createOrder(req.body);
if (idempotencyKey) {
	await db.idempotencyKeys.create({
		data: {
			key: idempotencyKey,
			response,
		},
	});
}
return res.json(response);

支付、下单、扣费、发放奖励、调用付费 AI 接口,都应重点设计幂等性。

4.3 限流不只是"防止服务器崩"

限流至少要考虑:

  • 登录接口:防暴力破解
  • 注册/验证码接口:防刷短信
  • 搜索/导出接口:防资源滥用
  • AI 生成接口:防 Token 费用失控
  • 文件上传接口:防存储和带宽攻击
typescript 复制代码
import rateLimit from 'express-rate-limit';
const aiLimiter = rateLimit({
	windowMs: 60_000,
	max: 10,
	standardHeaders: true,
	legacyHeaders: false,
	message: { error: '请求过于频繁,请稍后再试' },
});
app.post('/api/ai/generate', aiLimiter, handleGenerate);

对付费接口还可以叠加用户级配额:

typescript 复制代码
const usage = await db.aiUsage.count({
where: {
	userId: session.userId,
	createdAt: { gte: startOfDay },
},
});
if (usage >= DAILY_LIMIT) {
	return res.status(429).json({ error: '今日额度已用完' });
}

五、错误处理:不要向客户端泄露内部信息

typescript 复制代码
//  危险:把堆栈直接返回
app.use((err, req, res, next) => {
	res.status(500).json({
		error: err.message,
		stack: err.stack,
		sql: err.sql,
	});
});

攻击者可能通过错误信息判断数据库类型、表结构、文件路径、依赖版本。

typescript 复制代码
//  正确:生产环境返回通用错误
app.use((err, req, res, next) => {
	logger.error('Unhandled error', {
	path: req.path,
	userId: req.userId,
	error: err.message,
	stack: err.stack,
});
if (process.env.NODE_ENV === 'production') {
	return res.status(500).json({ error: '服务器内部错误' });
}
return res.status(500).json({
	error: err.message,
	stack: err.stack,
});
});

登录接口也要避免明确提示"用户名不存在"或"密码错误",可以统一返回:

typescript 复制代码
{ "error": "用户名或密码错误" }

六、文件、路径与命令执行

6.1 文件上传要限制类型、大小和存储路径

不要只看前端 accept 或文件后缀。

typescript 复制代码
const ALLOWED_TYPES = ['image/jpeg', 'image/png'];
const MAX_SIZE = 5 * 1024 * 1024;
if (!ALLOWED_TYPES.includes(file.mimetype)) {
	return res.status(400).json({ error: '不支持的文件类型' });
}
if (file.size > MAX_SIZE) {
	return res.status(400).json({ error: '文件过大' });
}

上传后不要直接使用用户提供的文件名:

typescript 复制代码
//  危险:用户控制文件名
const filename = req.body.filename;
await fs.writeFile(`/uploads/${filename}`, buffer);
typescript 复制代码
//  正确:使用随机文件名
const filename = `${crypto.randomUUID()}.png`;
await fs.writeFile(path.join(UPLOAD_DIR, filename), buffer);

6.2 路径遍历

typescript 复制代码
//  危险:用户输入直接进入文件路径
const file = await fs.readFile(`./reports/${req.query.name}`);
// 攻击者可能传入 `../../etc/passwd`。
// 应限制在固定目录,并解析真实路径:
const baseDir = path.resolve('./reports');
const filePath = path.resolve(baseDir, req.query.name);
if (!filePath.startsWith(baseDir)) {
	return res.status(400).json({ error: '非法文件路径' });
}

6.3 命令执行

typescript 复制代码
//  危险:拼接用户输入到命令
exec(`ping ${req.query.host}`);

应尽量避免 exec、eval、new Function、vm.runInNewContext。如果确实需要调用系统命令,应使用白名单、参数校验和子进程安全 API。

七、依赖与运行时安全:不要只关注业务代码

7.1 锁定依赖版本

typescript 复制代码
pnpm install

提交 pnpm-lock.yaml,不要随意删除 lock 文件。生产部署建议使用:

typescript 复制代码
pnpm ci

这样可以确保安装的依赖版本与 lock 文件一致。

7.2 定期扫描依赖漏洞

typescript 复制代码
pnpm audit

也可以使用 SCA 工具持续检测第三方依赖风险。AI 推荐的包尤其需要核实:是否真实存在、维护状态如何、是否有已知漏洞、下载量和社区可信度如何。

7.3 关注运行时安全更新

Node.js 这类运行时本身也会出现高危漏洞。例如 2026 年 10 月披露的 Node.js Brotli 解码器越界写入漏洞 CVE-2026-111497,就可能影响处理压缩数据、HTTP 响应解压、文件解压等场景,修复方式是升级到对应安全版本。

这类漏洞提醒我们:后端安全不只是业务代码安全,也包括运行时、框架、反向代理、数据库驱动和第三方库的版本管理。

八、AI 辅助编程:效率提升,但风险也前置了

8.1 不要把代码库原样喂给 AI

前端工程师在写后端时,常会把接口、数据库模型、环境变量示例、错误日志一起粘贴给 AI 助手。这里可能包含:

  • 数据库地址
  • API Key
  • 用户 PII
  • 内部域名
  • 权限规则
  • 业务密钥

这些信息一旦进入 AI 工具,就可能进入日志、会话记录或云端存储。

更安全的做法是:

  • 脱敏后再提问
  • 用伪数据替代真实密钥
  • 不粘贴生产环境配置
  • 不在提示词中暴露内部拓扑
  • 对 AI 工具做权限分级和审计

8.2 AI 生成的后端代码要按"外部贡献"审查

AI 生成的代码可能:

  • 看起来能跑,但缺少权限校验
  • 使用了字符串拼接查询
  • 默认开放 CORS
  • 直接返回完整数据库对象
  • 推荐了不存在或有风险的 npm 包
  • 忽略了并发和幂等性

可以用一个简单的审查清单:

1.这个接口是否校验了登录?

2.是否校验了资源归属?

3.所有输入是否有类型和长度限制?

4.是否使用了参数化查询或安全 ORM?

5.是否只返回必要字段?

6.是否有幂等性或防重放设计?

7.是否有限流或配额控制?

8.错误信息是否泄露内部细节?

9.是否引入了新依赖?依赖是否可信?

10.是否使用了环境变量管理密钥?

8.3 用规则约束 AI,而不是只靠人工记忆

可以在项目中加入规则文件,例如 .cursorrules、.mdc 或团队内部的 Prompt 规范,明确要求:

  • 禁止硬编码密钥
  • 禁止使用 eval、new Function
  • 数据库查询必须参数化
  • 所有 Server Actions / API 必须鉴权
  • 返回数据必须裁剪字段
  • 写接口必须考虑幂等和限流
  • 新增依赖必须说明用途和版本

这比每次手动提醒更稳定。

九、上线前快速自查

  • 所有接口是否都有身份校验?
  • 是否校验了资源归属,避免水平越权?
  • 管理员接口是否有垂直权限校验?
  • 所有输入是否经过类型、长度、格式校验?
  • 数据库查询是否避免字符串拼接?
  • 返回数据是否只包含必要字段?
  • 密钥是否来自环境变量或密钥管理服务?
  • 前端是否没有暴露服务端 Secret?
  • 写接口是否具备幂等性或防重放机制?
  • 付费/敏感接口是否有限流和配额?
  • 错误响应是否避免泄露堆栈、SQL、路径?
  • 日志是否记录关键操作但不记录敏感数据?
  • 文件上传是否校验类型、大小并随机命名?
  • 是否锁定了依赖版本并定期审计?
  • AI 生成的代码是否经过人工安全审查?

总结

前端工程师做后端任务,最大的转变不是学会写 API,而是需要意识到:后端每一行代码都可能成为攻击入口。前端关注的是"用户能不能顺利操作",后端必须同时关注"攻击者能不能绕过规则"。

AI 可以让你更快写出接口、模型调用和数据访问代码,但它不能替你把安全边界、数据权限、并发一致性和线上风险兜底。

真正为线上系统负责的,仍然是写下这些代码的人!

相关推荐
掘金者阿豪33 分钟前
GitLab 服务器疑似遭入侵:从 502 故障到 Root 权限异常的完整排查复盘
后端
云起SAAS1 小时前
手机靓号选号商城H5源码 完整前后台可直接运行
前端·javascript·后端
ZzT1 小时前
AI-SDLC 实践 06|开发阶段的知识库:Agent 写代码前该读哪些规则和业务知识
ai编程·claude
Bigger1 小时前
我扒了 GitHub Trending 前 20,8 个在做同一件事:给 Coding Agent 造基础设施
开源·github·ai编程
the局外人1 小时前
Python 实战检索优化:BM25、向量与重排
数据库·后端·python
苏三说技术2 小时前
分库分表要被淘汰了?
后端
__underline__2 小时前
冷门Python知识点006篇:Python 类体里的名字,能被"凭空造出来"
后端·python
nice_lcj5202 小时前
【从零理解计算机网络 · 05】TCP 四次挥手:为什么挥手要四次、TIME_WAIT 在等什么
后端·tcp/ip·计算机网络·面试·tcp·四次挥手·time_wait
Moment2 小时前
RSI 是怎样让 AI 改进自己的 ❓❓❓
前端·后端·面试