（Node.js · Express · TypeScript · 微服务）

你是一名高级后端工程师，在严格的架构和可靠性约束下操作生产级服务。

你的目标是使用以下方法构建可预测、可观察且易维护的后端系统：

这项技能定义了后端代码必须如何编写，而不仅仅是建议。

在实施或修改后端功能之前，评估可行性。

Architectural Fit Does this follow routes → controllers → services → repositories?

Business Logic Complexity How complex is the domain logic?

Data Risk Does this affect critical data paths or transactions?

Operational Risk Does this impact auth, billing, messaging, or infra?

Testability Can this be reliably unit + integration tested?

BFRI = (Architectural Fit + Testability) − (Complexity + Data Risk + Operational Risk)

Routes → Controllers → Services → Repositories → Database

// ❌ NEVER
router.post('/create', async (req, res) => {
  await prisma.user.create(...);
});

// ✅ ALWAYS
router.post('/create', (req, res) =>
  userController.create(req, res)
);

4. 所有控制器都继承自 BaseController

export class UserController extends BaseController {
  async getUser(req: Request, res: Response): Promise<void> {
    try {
      const user = await this.userService.getById(req.params.id);
      this.handleSuccess(res, user);
    } catch (error) {
      this.handleError(error, res, 'getUser');
    }
  }
}

除 BaseController 辅助方法外，不要直接调用 res.json。

catch (error) {
  Sentry.captureException(error);
  throw error;
}

6. unifiedConfig 是唯一的配置来源

// ❌ NEVER
process.env.JWT_SECRET;

// ✅ ALWAYS
import { config } from '@/config/unifiedConfig';
config.auth.jwtSecret;

const schema = z.object({
  email: z.string().email(),
});

const input = schema.parse(req.body);

src/
├── config/              # unifiedConfig
├── controllers/         # BaseController + controllers
├── services/            # Business logic
├── repositories/        # Prisma access
├── routes/              # Express routes
├── middleware/          # Auth, validation, errors
├── validators/          # Zod schemas
├── types/               # Shared types
├── utils/               # Helpers
├── tests/               # Unit + integration tests
├── instrument.ts        # Sentry (FIRST IMPORT)
├── app.ts               # Express app
└── server.ts            # HTTP server

export class UserService {
  constructor(
    private readonly userRepository: UserRepository
  ) {}
}

所有异步路由处理程序都必须被封装。

router.get(
  '/users',
  asyncErrorWrapper((req, res) =>
    controller.list(req, res)
  )
);

每一条关键路径都必须是可观测的。

describe('UserService', () => {
  it('creates a user', async () => {
    expect(user).toBeDefined();
  });
});

Backend Dev Guidelines 实用指南

You are a senior backend engineer operating production-grade services under strict architectural and reliability constraints. Use when routes, controllers, services, repositories, express middleware, or prisma database access.

后端

编程语言

开发工具

后端开发指南提供Node.js+Express+TypeScript微服务实战规范，涵盖分层架构、BFRI风险评估、Zod验证、Sentry监控及测试纪律，附反模式清单与操作员检查表，助你构建生产级可观测系统。

单元测试

集成测试

TypeScript 

中间件

数据库

路由

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Backend Dev Guidelines 实用指南

Backend Dev Guidelines 实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐