文章目录
-
- 一、先建立后端思维:前端是体验层,后端是安全边界
- 二、安全边界:永远不要信任客户端
-
- [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 可以让你更快写出接口、模型调用和数据访问代码,但它不能替你把安全边界、数据权限、并发一致性和线上风险兜底。
真正为线上系统负责的,仍然是写下这些代码的人!