
Hướng dẫn này trình bày chi tiết quy trình di chuyển các microservice Node.js hiện có sang Bun 1.2 để triển khai sản xuất. Chúng ta sẽ đề cập đến việc di chuyển máy chủ HTTP, tích hợp bun:sqlite, triển khai máy chủ WebSocket, khả năng tương thích của gói npm, các cân nhắc về addon C++ gốc, giảm thiểu khoảng trống API của Node.js và đóng gói Docker với các điểm chuẩn hiệu suất.
Bun 1.2 mang lại những lợi thế đáng kể về hiệu suất so với Node.js, chủ yếu nhờ vào việc triển khai Zig cơ bản và công cụ JavaScriptCore. Các lợi ích chính bao gồm:
bun install, bun run, bun test và bun build hợp lý hóa quy trình phát triển.bun:sqlite, bun:ffi, bun:serve cung cấp các nguyên thủy được tối ưu hóa cao.Máy chủ HTTP gốc của Bun (Bun.serve) là một giải pháp thay thế hiệu suất cao cho mô-đun http của Node.js hoặc các framework như Express. Nó được thiết kế để có chi phí tối thiểu.
// src/node-server.ts
import express from 'express';
import { readFileSync } from 'fs';
import path from 'path';
const app = express();
const port = process.env.PORT ? parseInt(process.env.PORT) : 3000;
app.use(express.json());
app.get('/', (req, res) => {
res.send('Hello from Node.js Express!');
});
app.get('/data', (req, res) => {
try {
const data = readFileSync(path.join(__dirname, '../data.json'), 'utf8');
res.json(JSON.parse(data));
} catch (error) {
console.error('Error reading data:', error);
res.status(500).send('Internal Server Error');
}
});
app.listen(port, () => {
console.log(`Node.js Express server listening on port ${port}`);
});
Bun.serve)Di chuyển sang Bun.serve liên quan đến việc điều chỉnh xử lý yêu cầu/phản hồi. Các đối tượng Request và Response của Bun là các đối tượng Request và Response tiêu chuẩn Web.
// src/bun-server.ts
import { readFileSync } from 'fs';
import path from 'path';
const port = process.env.PORT ? parseInt(process.env.PORT) : 3000;
const server = Bun.serve({
port,
async fetch(req: Request): Promise<Response> {
const url = new URL(req.url);
if (url.pathname === '/') {
return new Response('Hello from Bun!', { status: 200 });
}
if (url.pathname === '/data') {
try {
const dataPath = path.join(import.meta.dir, '../data.json');
const data = readFileSync(dataPath, 'utf8');
return new Response(data, {
headers: { 'Content-Type': 'application/json' },
status: 200,
});
} catch (error) {
console.error('Error reading data:', error);
return new Response('Internal Server Error', { status: 500 });
}
}
// Example for POST request with JSON body
if (url.pathname === '/submit' && req.method === 'POST') {
try {
const body = await req.json();
console.log('Received JSON body:', body);
return new Response(JSON.stringify({ message: 'Data received', data: body }), {
headers: { 'Content-Type': 'application/json' },
status: 200,
});
} catch (error) {
console.error('Error parsing JSON body:', error);
return new Response('Bad Request: Invalid JSON', { status: 400 });
}
}
return new Response('Not Found', { status: 404 });
},
error(error: Error): Response {
console.error('Bun server error:', error);
return new Response('Internal Server Error', { status: 500 });
},
});
console.log(`Bun server listening on port ${server.port}`);
Lưu ý việc sử dụng import.meta.dir để phân giải đường dẫn, đây là tương đương của Bun với __dirname của Node.js.
bun:sqliteBun cung cấp một máy khách SQLite gốc, được tối ưu hóa cao thông qua bun:sqlite. Điều này loại bỏ nhu cầu về các gói npm bên ngoài như sqlite3 hoặc better-sqlite3, vốn thường liên quan đến các addon C++ gốc và các bước biên dịch.
better-sqlite3)// src/node-sqlite.ts
import Database from 'better-sqlite3';
import path from 'path';
const dbPath = path.join(__dirname, '../data.db');
const db = new Database(dbPath);
db.exec(`
CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY AUTOINCREMENT,
name TEXT NOT NULL,
email TEXT UNIQUE NOT NULL
);
`);
export function insertUser(name: string, email: string) {
const stmt = db.prepare('INSERT INTO users (name, email) VALUES (?, ?)');
const info = stmt.run(name, email);
return info.lastInsertRowid;
}
export function getUsers() {
const stmt = db.prepare('SELECT * FROM users');
return stmt.all();
}
// Example usage
if (require.main === module) {
insertUser('Alice', 'alice@example.com');
insertUser('Bob', 'bob@example.com');
console.log('Users:', getUsers());
db.close();
}
bun:sqlite)bun:sqlite cung cấp một bề mặt API tương tự, giúp việc di chuyển trở nên đơn giản.
// src/bun-sqlite.ts
import { Database } from 'bun:sqlite';
import path from 'path';
const dbPath = path.join(import.meta.dir, '../data.db');
const db = new Database(dbPath);
db.run(`
CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY AUTOINCREMENT,
name TEXT NOT NULL,
email TEXT UNIQUE NOT NULL
);
`);
export function insertUser(name: string, email: string) {
const query = db.query('INSERT INTO users (name, email) VALUES (?, ?)');
const result = query.run(name, email);
// Bun's result object for INSERT operations might differ slightly
// For SQLite, lastInsertRowid is often available on the database object or via PRAGMA
// For simplicity, we'll assume a successful run implies insertion.
// A more robust solution would query for the last_insert_rowid()
const lastIdQuery = db.query('SELECT last_insert_rowid() as id;');
return (lastIdQuery.get() as { id: number }).id;
}
export function getUsers() {
const query = db.query('SELECT * FROM users');
return query.all();
}
// Example usage
if (import.meta.main) {
insertUser('Charlie', 'charlie@example.com');
insertUser('David', 'david@example.com');
console.log('Users:', getUsers());
db.close();
}
Bun.serve của Bun cũng bao gồm hỗ trợ hạng nhất cho WebSockets, cung cấp một giải pháp tích hợp, hiệu suất cao.
ws)// src/node-ws.ts
import { WebSocketServer } from 'ws';
const wss = new WebSocketServer({ port: 8080 });
wss.on('connection', ws => {
console.log('Client connected (Node.js WS)');
ws.on('message', message => {
console.log(`Received: ${message}`);
ws.send(`Echo: ${message}`);
});
ws.on('close', () => console.log('Client disconnected (Node.js WS)'));
ws.on('error', error => console.error('WebSocket error (Node.js WS):', error));
});
console.log('Node.js WebSocket server listening on port 8080');
Bun.serve)API WebSocket của Bun được tích hợp trực tiếp vào Bun.serve, sử dụng đối tượng cấu hình websocket.
// src/bun-ws.ts
const server = Bun.serve({
port: 8080,
fetch(req, server) {
const url = new URL(req.url);
if (url.pathname === '/ws') {
const success = server.upgrade(req, {
data: {
// Optional: attach any data to the WebSocket connection
connectedAt: Date.now(),
},
});
if (success) {
return; // Bun handles the WebSocket connection
}
}
return new Response('Not Found', { status: 404 });
},
websocket: {
open(ws) {
console.log(`Client connected (Bun WS). Connected at: ${ws.data.connectedAt}`);
ws.send('Welcome to Bun WebSocket!');
},
message(ws, message) {
console.log(`Received: ${message}`);
ws.send(`Echo: ${message}`);
},
close(ws, code, message) {
console.log(`Client disconnected (Bun WS). Code: ${code}, Message: ${message}`);
},
error(ws, error) {
console.error('WebSocket error (Bun WS):', error);
},
// Optional: perMessageDeflate, maxPayloadLength, idleTimeout
// idleTimeout: 30, // seconds
},
});
console.log(`Bun WebSocket server listening on port ${server.port}`);
Bun hướng tới khả năng tương thích cao với các gói npm hiện có. Hầu hết các gói JavaScript thuần túy sẽ hoạt động mà không cần sửa đổi.
Đây là nơi khả năng tương thích có thể gây khó khăn. Các addon gốc của Node.js (tệp .node) được biên dịch dựa trên N-API (Node-API) và công cụ V8 của Node.js. Bun sử dụng JavaScriptCore và FFI (Foreign Function Interface) riêng của nó cho các tương tác gốc.
bun:ffi: Đối với các hoạt động nhạy cảm về hiệu suất quan trọng, bạn có thể cần viết lại logic gốc bằng cách sử dụng bun:ffi để gọi vào một thư viện chia sẻ (.so, .dylib, .dll) được biên dịch đặc biệt cho Bun. Đây là một công việc phức tạp.bcrypt (Addon gốc)bcrypt là một gói phổ biến sử dụng các addon C++ gốc để tăng hiệu suất.
// src/node-bcrypt.ts
import bcrypt from 'bcrypt';
async function hashPassword(password: string) {
const saltRounds = 10;
const hashedPassword = await bcrypt.hash(password, saltRounds);
console.log('Hashed password (Node.js):', hashedPassword);
return hashedPassword;
}
async function verifyPassword(password: string, hash: string) {
const isMatch = await bcrypt.compare(password, hash);
console.log('Password match (Node.js):', isMatch);
return isMatch;
}
if (require.main === module) {
(async () => {
const hash = await hashPassword('mysecretpassword');
await verifyPassword('mysecretpassword', hash);
await verifyPassword('wrongpassword', hash);
})();
}
Khi chạy bun install bcrypt, Bun sẽ cố gắng cài đặt nó. Nếu nó không xây dựng được addon gốc, bạn sẽ thấy lỗi. Đối với những trường hợp như vậy, bạn có thể cần sử dụng một giải pháp thay thế JS thuần túy hoặc một cách tiếp cận khác.
bcrypt với các vấn đề tiềm ẩn)Bun đôi khi có thể chạy các addon gốc của Node.js nếu chúng được biên dịch trước cho kiến trúc và phiên bản N-API chính xác, nhưng điều này không được đảm bảo và thường thất bại. Một cách tiếp cận an toàn hơn là sử dụng một giải pháp thay thế JS thuần túy hoặc một thư viện khác.
Đối với bcrypt, một triển khai JS thuần túy như bcryptjs thường là một giải pháp dự phòng khả thi, mặc dù nó sẽ chậm hơn.
// src/bun-bcryptjs.ts
import bcrypt from 'bcryptjs'; // Using bcryptjs for Bun compatibility
async function hashPassword(password: string) {
const saltRounds = 10;
const hashedPassword = await bcrypt.hash(password, saltRounds);
console.log('Hashed password (Bun/bcryptjs):', hashedPassword);
return hashedPassword;
}
async function verifyPassword(password: string, hash: string) {
const isMatch = await bcrypt.compare(password, hash);
console.log('Password match (Bun/bcryptjs):', isMatch);
return isMatch;
}
if (import.meta.main) {
(async () => {
const hash = await hashPassword('mysecretpassword');
await verifyPassword('mysecretpassword', hash);
await verifyPassword('wrongpassword', hash);
})();
}
Mặc dù Bun hướng tới khả năng tương thích cao với Node.js, nhưng một số API không được triển khai đầy đủ hoặc hoạt động khác nhau.
child_process: Hầu hết các hàm phổ biến như exec, spawn, fork đều được hỗ trợ. Các trường hợp đặc biệt hoặc các tùy chọn cụ thể có thể khác nhau.vm: Hỗ trợ hạn chế. Nếu ứng dụng của bạn phụ thuộc nhiều vào vm.runInContext hoặc tương tự, đây có thể là một trở ngại.domain: Đã bị loại bỏ trong Node.js, không được hỗ trợ trong Bun.cluster: Bun không có một tương đương trực tiếp cho cluster. Để sử dụng đa lõi, bạn thường chạy nhiều tiến trình Bun và sử dụng bộ cân bằng tải, hoặc tận dụng đa luồng tích hợp của Bun cho một số tác vụ nhất định (mặc dù không phải để mở rộng máy chủ HTTP theo cách cluster hoạt động).fs: Tương thích phần lớn, nhưng một số tùy chọn ít phổ biến hơn hoặc các biến thể đồng bộ có thể có những khác biệt nhỏ. Luôn kiểm tra các hoạt động nặng về hệ thống tệp.net / tls: Chức năng máy khách/máy chủ cơ bản có mặt, nhưng các cấu hình nâng cao có thể yêu cầu điều chỉnh.Chiến lược giảm thiểu:
Đóng gói các ứng dụng Bun vào container rất đơn giản. Các hình ảnh Docker oven/bun chính thức cung cấp một cơ sở gọn nhẹ.
# Dockerfile.node
FROM node:20-alpine AS base
WORKDIR /app
COPY package.json bun.lockb* ./
RUN npm install --frozen-lockfile
COPY . .
EXPOSE 3000
CMD ["node", "src/node-server.ts"]
# Dockerfile.bun
FROM oven/bun:1.2.0-alpine AS base
WORKDIR /app
COPY package.json bun.lockb* ./
# Bun automatically installs dependencies on 'bun run' if not present,
# but explicit install is good practice for build stage.
RUN bun install --frozen-lockfile
COPY . .
EXPOSE 3000
CMD ["bun", "run", "src/bun-server.ts"]
Chúng ta sẽ so sánh kích thước hình ảnh và mức sử dụng bộ nhớ thời gian chạy cho một máy chủ HTTP đơn giản.
docker build -t node-app -f Dockerfile.node .
docker build -t bun-app -f Dockerfile.bun .
docker images | grep "node-app\|bun-app"
docker stats):
docker run -d --name node-server -p 3001:3000 node-app
docker run -d --name bun-server -p 3002:3000 bun-app
docker stats --no-stream node-server bun-server
# Stop containers after collecting stats
docker stop node-server bun-server && docker rm node-server bun-server
| Chỉ số | Node.js (20-alpine) | Bun (1.2.0-alpine) | Ghi chú |
|---|---|---|---|
| Kích thước hình ảnh | ~180 MB | ~100 MB | Hình ảnh cơ sở của Bun nhỏ hơn đáng kể. |
| Thời gian khởi động | ~500 ms | ~50 ms | Bun nhanh hơn nhiều lần. |
| Mức sử dụng bộ nhớ | ~30 MB | ~10 MB | Đối với một máy chủ HTTP đơn giản, Bun sử dụng ít hơn. |
| RPS (ab -c 50 -n 10000) | ~2500 RPS | ~7000 RPS | Bun.serve được tối ưu hóa cao. |
Lưu ý: Đây là các điểm chuẩn minh họa. Kết quả thực tế phụ thuộc rất nhiều vào độ phức tạp của ứng dụng, khối lượng công việc và phần cứng.
Error: Cannot find module '...':
tsconfig.json không được cấu hình chính xác cho Bun.tsconfig.json paths được ánh xạ chính xác và baseUrl được đặt.package.json exports cho các gói đã nhập.bun install hoặc npm install bị thiếu nếu sử dụng kết hợp.node_modules của Bun có thể nghiêm ngặt hơn; đảm bảo tất cả các phụ thuộc được liệt kê rõ ràng.require(), đảm bảo phần mở rộng tệp có mặt (ví dụ: require('./module.js')).Lỗi Addon gốc:
.node) với Bun.bcryptjs thay vì bcrypt).bun:ffi (nâng cao).Sự khác biệt process.env:
process.env của Bun phần lớn là tương thích, nhưng một số biến môi trường dành riêng cho Node.js có thể không có mặt hoặc hoạt động không giống nhau.Không nhất quán API Buffer:
Buffer, nhưng việc triển khai cơ bản của nó có thể có những khác biệt nhỏ so với Node.js, đặc biệt với các phương thức Buffer cũ hơn hoặc ít phổ biến hơn.Uint8Array và TextEncoder/TextDecoder tiêu chuẩn Web nếu có thể.Buffer.Hành vi fs.watch / fs.watchFile:
Bun.serve so với Máy chủ HTTP Node.js keepAliveTimeout:
Bun.serve của Bun có idleTimeout cho WebSockets và thời gian chờ kết nối chung. Node.js có keepAliveTimeout. Các giá trị mặc định và hành vi có thể khác nhau.idleTimeout trong Bun.serve cho WebSockets.fetch của bạn nếu cần.Hỏi: Tôi có thể sử dụng các framework Node.js hiện có như Express hoặc NestJS với Bun không?
Bun.serve cho việc xử lý HTTP. Để có hiệu suất tối ưu, hãy di chuyển các endpoint HTTP sang Bun.serve trực tiếp hoặc sử dụng một framework gốc của Bun. bun install thường sẽ xử lý các phụ thuộc của framework.Hỏi: Bun xử lý việc biên dịch TypeScript trong sản xuất như thế nào?
.ts bằng bun run src/index.ts. Đối với sản xuất, bun build có thể biên dịch TypeScript của bạn thành JavaScript, sau đó có thể chạy. Điều này loại bỏ nhu cầu về tsc hoặc ts-node.Hỏi: Còn các trình điều khiển cơ sở dữ liệu khác ngoài SQLite (ví dụ: PostgreSQL, MySQL) thì sao?
pg, mysql2, sequelize, prisma). Chúng thường là JavaScript thuần túy hoặc dựa vào các giao thức mạng tiêu chuẩn, vì vậy chúng thường hoạt động tốt với Bun. bun install sẽ quản lý các phụ thuộc của chúng.Hỏi: bun:ffi có phải là một giải pháp thay thế khả thi cho tất cả các addon gốc của Node.js không?
bun:ffi rất mạnh mẽ nhưng đòi hỏi nỗ lực đáng kể. Bạn cần viết mã C/C++/Rust, biên dịch nó thành một thư viện chia sẻ (.so, .dylib, .dll), sau đó định nghĩa các chữ ký hàm trong TypeScript để bun:ffi gọi. Đây là một giải pháp cho logic gốc quan trọng về hiệu suất, được cô lập, không phải là một giải pháp thay thế trực tiếp cho các addon Node.js phức tạp.Hỏi: Làm cách nào để gỡ lỗi một ứng dụng Bun trong sản xuất?
--inspect hoặc --inspect-brk (ví dụ: bun --inspect src/index.ts) và kết nối một trình gỡ lỗi (như trình gỡ lỗi của VS Code hoặc Chrome DevTools). Điều này cung cấp trải nghiệm gỡ lỗi quen thuộc tương tự như Node.js.Một nhóm phát triển đang di chuyển một microservice Node.js sang Bun 1.2. Microservice này thường xuyên scale up và scale down dựa trên các đợt tăng đột biến về traffic và được triển khai dưới dạng serverless functions. Lợi thế cốt lõi nào của Bun sẽ mang lại lợi ích tức thì đáng kể nhất trong kịch bản sản xuất cụ thể này?
Làm sạch log AI CLI, tạo biểu thức cron, giải mã JWT và tính quyền chmod offline.

Hướng dẫn toàn diện về di chuyển từ Redis sang Valkey 8 trong môi trường production: nhân bản không downtime và kiểm tra độ trễ với kiến trúc cấp độ production cùng các ví dụ code.
Đọc tiếp
Hướng dẫn toàn diện về turso & libsql: sqlite phân tán với các bản sao nhúng cho backend độ trễ thấp với kiến trúc cấp độ sản xuất và ví dụ code.
Đọc tiếp
Hướng dẫn toàn diện về các chiến lược database seeding hiện đại sử dụng Prisma và TypeScript, khám phá tính idempotency, tích hợp Faker.js, xử lý dữ liệu quan hệ phức tạp và tối ưu hóa hiệu suất cho các seed script lớn.
Đọc tiếp