Урок 022 минуты чтения
Как собрать app и server в готовом проекте?
На этой странице
Кратко
В итоговом приложении app.ts задаёт порядок промежуточных обработчиков и маршрутов, а server.ts проверяет базу, открывает порт и корректно закрывает ресурсы.
Вопрос
Как собрать app.ts и server.ts в готовом Express-проекте? В каком порядке подключать middleware и ресурсы?
app.ts
import cors from "cors";
import express from "express";
import helmet from "helmet";
import { env } from "./config/env.js";
import { errorHandler } from "./middleware/error-handler.js";
import { notFoundHandler } from "./middleware/not-found-handler.js";
import { usersRouter } from "./modules/users/users.routes.js";
export const app = express();
app.disable("x-powered-by");
app.use(helmet());
app.use(
cors({
origin: env.CLIENT_ORIGIN,
credentials: true,
}),
);
app.use(express.json({ limit: "100kb" }));
app.get("/health/live", (request, response) => {
response.json({ status: "ok" });
});
app.use("/api/users", usersRouter);
app.use(notFoundHandler);
app.use(errorHandler);server.ts
import { app } from "./app.js";
import { env } from "./config/env.js";
import { pool } from "./db/index.js";
await pool.query("SELECT 1");
const server = app.listen(env.PORT, () => {
console.log(`Сервер запущен: http://localhost:${env.PORT}`);
});
let isShuttingDown = false;
async function shutdown(signal: string) {
if (isShuttingDown) return;
isShuttingDown = true;
console.log({ message: "Остановка", signal });
server.close(async (serverError) => {
try {
await pool.end();
process.exitCode = serverError ? 1 : 0;
} catch (error) {
console.error(error);
process.exitCode = 1;
}
});
}
process.once("SIGTERM", () => void shutdown("SIGTERM"));
process.once("SIGINT", () => void shutdown("SIGINT"));Почему порядок именно такой
защитные заголовки
→ CORS
→ разбор JSON
→ служебные маршруты
→ API
→ 404
→ ошибкиОбработчик ошибок должен видеть ошибки всех предыдущих обработчиков.
Что ещё потребуется в рабочем окружении
- HTTPS и обратный прокси;
- структурированный журнал;
- внешний хранитель сессий, если они используются;
- наблюдение за ошибками и длительностью;
- резервные копии PostgreSQL;
- отдельный шаг миграций;
- предельный срок остановки;
- автоматические проверки перед развёртыванием.
Что важно помнить
- Порядок в
app.ts: безопасность и журнал → парсеры → CORS → маршруты →404→ ошибки. server.tsпроверяет подключение к базе доlisten().- При остановке сначала закрывается HTTP-сервер, затем пул.
- В рабочем окружении добавляются
trust proxy, HTTPS на прокси и мониторинг.
Мини-шпаргалка
app.tsне открывает порт.server.tsпроверяет обязательную базу доlisten().- Порядок
app.use()влияет на поведение. 404идёт после маршрутов, ошибки — последними.- При остановке закрываются сервер и пул.
Документация
Express: Health checks and graceful shutdown, Express: Using middleware, Express: Writing middleware.
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.