Nuxt 4 Thực Sự Giải Quyết Vấn Đề Gì
Đến một lúc nào đó khi tự cấu hình Vue 3 — dù dùng Vite hay cách khác — bạn sẽ gặp phải cùng một vấn đề. Router hoạt động, nhưng giờ bạn cần SSR. SSR hoạt động, nhưng giờ bạn cần một tầng API. Đột nhiên bạn đang quản lý ba mảng riêng biệt. Nuxt 4 gộp tất cả lại thành một.
Ba điều quan trọng nhất với bất kỳ ai muốn phát triển ứng dụng full-stack:
- Server-Side Rendering (SSR) — trang được render trên server trước khi trình duyệt nhận bất kỳ thứ gì. Thời gian hiển thị đầu tiên nhanh hơn, và công cụ tìm kiếm index nội dung thực thay vì một shell trống. Không cần cấu hình gì để bắt đầu.
- Auto-imports — Vue composables, components và utilities có sẵn ở mọi nơi mà không cần một câu lệnh
importnào. File code gọn gàng hơn. Lỗi copy-paste do thiếu import biến mất hoàn toàn. - Nitro server — một engine server tích hợp xử lý cả SSR lẫn các API route của bạn. Chỉ cần đặt một file vào
server/api/và Nitro sẽ tự động expose nó thành REST endpoint. Không cần cấu hình router, không cần Express config.
Khi triển khai stack này trên hai site production, TTFB giảm từ khoảng 800ms xuống dưới 200ms so với Vue SPA render phía client. Codebase cũng gọn hơn — không cần service backend riêng để xử lý data fetching đơn giản.
Hướng dẫn này đưa bạn từ terminal trống đến một bản build production đang chạy. Không yêu cầu kinh nghiệm Nuxt trước đó.
Cài Đặt
Yêu Cầu Trước Khi Bắt Đầu
Nuxt 4 yêu cầu Node.js 20 trở lên. Kiểm tra phiên bản của bạn trước:
node -v
# Kết quả phải là v20.x.x trở lên
Đang dùng phiên bản cũ hơn? Dùng nvm để nâng cấp mà không ảnh hưởng đến các project khác:
nvm install 20
nvm use 20
Khởi Tạo Project
Nuxt CLI chính thức cài đặt mọi thứ chỉ với một lệnh — Vite, Vue 3, hỗ trợ TypeScript và Nitro server đều được tích hợp sẵn:
npx nuxi@latest init my-nuxt-app
cd my-nuxt-app
npm install
Wizard cài đặt sẽ hỏi bạn muốn dùng package manager nào. Cả npm lẫn pnpm đều ổn. Với production, nên chuyển sang pnpm — tốc độ cài đặt nhanh hơn khoảng 2 lần và node_modules chiếm khoảng một nửa dung lượng ổ đĩa so với npm trên cùng project.
# Tùy chọn: dùng pnpm thay thế
npm install -g pnpm
pnpm install
Tổng Quan Cấu Trúc Project
Cấu trúc project sau khi khởi tạo trông như sau:
my-nuxt-app/
├── app.vue # Component Vue gốc
├── nuxt.config.ts # Cấu hình Nuxt chính
├── pages/ # Routing dựa trên file
├── components/ # Vue components được auto-import
├── composables/ # Composables được auto-import
├── server/
│ └── api/ # Nitro API routes
└── public/ # Tài nguyên tĩnh
Mỗi thư mục có vai trò riêng. Điểm mấu chốt: Nuxt đọc các thư mục này tự động. Route tự đăng ký, component tự import, và API endpoint xuất hiện ngay khi bạn tạo file.
Cấu Hình
Bật và Tinh Chỉnh SSR
SSR được bật mặc định. Mở nuxt.config.ts để xác nhận và thêm metadata head cơ bản:
// nuxt.config.ts
export default defineNuxtConfig({
ssr: true, // Mặc định đã là true
app: {
head: {
title: 'My Nuxt App',
meta: [
{ name: 'description', content: 'Ứng dụng full-stack xây dựng với Nuxt 4' }
]
}
}
})
Một số trang không cần SSR — ví dụ như dashboard người dùng đằng sau tường đăng nhập. Vô hiệu hóa theo từng route bằng definePageMeta:
// pages/dashboard.vue
<script setup lang="ts">
definePageMeta({
ssr: false // Chỉ render phía client
})
</script>
Auto-imports trong Thực Tế
Bất kỳ thứ gì đặt trong composables/ hoặc components/ đều có thể dùng toàn cục. Tạo một composable để lấy dữ liệu người dùng:
// composables/useUser.ts
export const useUser = () => {
const user = ref<{ name: string; email: string } | null>(null)
const fetchUser = async (id: number) => {
user.value = await $fetch(`/api/users/${id}`)
}
return { user, fetchUser }
}
Dùng nó trong bất kỳ trang nào — không cần câu lệnh import:
// pages/profile.vue
<script setup lang="ts">
const { user, fetchUser } = useUser() // Không cần import
await fetchUser(1)
</script>
<template>
<div v-if="user">
<h1>{{ user.name }}</h1>
<p>{{ user.email }}</p>
</div>
</template>
Tất cả built-ins của Vue 3 hoạt động theo cách tương tự — ref, computed, watch, onMounted, không cái nào cần import trong project Nuxt. Thay đổi đó một mình đã loại bỏ một lượng đáng ngạc nhiên code boilerplate lặp lại trong mỗi file component.
Viết API Routes với Nitro
Các file trong server/api/ tự động trở thành HTTP endpoint. Dưới đây là ví dụ tra cứu người dùng tối giản:
// server/api/users/[id].get.ts
export default defineEventHandler(async (event) => {
const id = getRouterParam(event, 'id')
// Thay thế bằng lệnh gọi cơ sở dữ liệu thực tế
const users: Record<string, { name: string; email: string }> = {
'1': { name: 'Alice', email: '[email protected]' },
'2': { name: 'Bob', email: '[email protected]' }
}
const user = users[id as string]
if (!user) {
throw createError({ statusCode: 404, message: 'Không tìm thấy người dùng' })
}
return user
})
Tên file [id].get.ts làm hai việc cùng lúc: [id] tạo tham số route động, và .get giới hạn endpoint chỉ nhận GET request. Muốn tạo POST endpoint? Đặt tên file là .post.ts. Nitro xử lý method routing mà không cần cấu hình thêm.
Để dùng database thực tế, SQLite hoạt động tốt trong quá trình phát triển. Cài đặt driver:
npm install better-sqlite3
npm install -D @types/better-sqlite3
// server/utils/db.ts
import Database from 'better-sqlite3'
const db = new Database('./dev.db')
// Tự động import trong tất cả file server/
export { db }
Biến Môi Trường và Runtime Config
Secrets không bao giờ nên nằm trong source code. Nuxt đọc file .env và ánh xạ biến qua runtimeConfig:
# .env
NUXT_SECRET_KEY=my-super-secret
NUXT_PUBLIC_API_BASE=https://api.example.com
// nuxt.config.ts
export default defineNuxtConfig({
runtimeConfig: {
secretKey: '', // Chỉ server (bị ghi đè bởi NUXT_SECRET_KEY)
public: {
apiBase: '' // Client + server (bị ghi đè bởi NUXT_PUBLIC_API_BASE)
}
}
})
Quy tắc đặt tên rất quan trọng: NUXT_SECRET_KEY ánh xạ đến runtimeConfig.secretKey, và NUXT_PUBLIC_API_BASE ánh xạ đến runtimeConfig.public.apiBase. Nuxt xử lý việc ánh xạ tự động dựa trên prefix — không cần parse thủ công. Truy cập chúng trong server routes:
// server/api/protected.get.ts
export default defineEventHandler((event) => {
const config = useRuntimeConfig(event)
// config.secretKey có thể dùng ở đây, không bao giờ bị expose ra client
return { status: 'ok' }
})
Kiểm Tra & Giám Sát
Chạy Development Server
Khởi động dev server và mở http://localhost:3000 trên trình duyệt:
npm run dev
Nuxt ghi log các route được phát hiện và xác nhận Nitro đang chạy. Màn hình khởi động bình thường trông như sau:
➜ Local: http://localhost:3000/
➜ Network: http://192.168.x.x:3000/
✓ Nitro built in 300ms
Build cho Production
Bản build production biên dịch mọi thứ vào thư mục .output/ duy nhất. Nitro đóng gói server và static assets lại với nhau:
npm run build
Sau khi build xong, khởi động server:
node .output/server/index.mjs
Không có Vite, không có dev dependencies trong runtime. Chỉ là output đã biên dịch chạy như một Node.js process bình thường.
Kiểm Tra SSR Có Thực Sự Hoạt Động Không
Mở DevTools, vào tab Network và tải lại trang. Click vào response HTML document chính. Khi SSR đang hoạt động, body của response chứa HTML đã được render đầy đủ — chứ không phải một <div id="app"></div> trống chờ JavaScript điền vào.
Kiểm tra nhanh hơn từ terminal:
curl http://localhost:3000/ | grep '<h1'
Nếu nội dung heading xuất hiện trong kết quả curl, trang đó đang được server-rendered. Không có gì trả về thì SSR không hoạt động với route đó.
Giám Sát với Nuxt DevTools
Nuxt 4 đi kèm với DevTools panel tích hợp sẵn. Bật nó trong nuxt.config.ts:
export default defineNuxtConfig({
devtools: { enabled: true }
})
Khởi động lại dev server và truy cập http://localhost:3000. Một icon Nuxt nhỏ xuất hiện ở cuối trang — click vào để mở panel. Từ đó bạn có thể kiểm tra:
- Tất cả các trang được phát hiện và tham số route của chúng
- Các composables và components được auto-import
- Server API routes được đăng ký bởi Nitro
- Các giá trị runtime config (chỉ public)
Endpoint Kiểm Tra Sức Khỏe Cơ Bản
Cung cấp cho nền tảng deploy của bạn một endpoint để ping. Một health check tối giản:
// server/api/health.get.ts
export default defineEventHandler(() => {
return {
status: 'ok',
timestamp: new Date().toISOString()
}
})
curl http://localhost:3000/api/health
# {"status":"ok","timestamp":"2024-..."}
Trỏ một uptime monitor — UptimeRobot, Betterstack, hoặc bất kỳ công cụ nào team bạn đang dùng — đến endpoint này. Bạn sẽ nhận được cảnh báo trong vòng một phút khi server ngừng hoạt động, thay vì biết qua báo cáo từ người dùng.
Các Bước Tiếp Theo
Đến đây bạn đã có SSR cho tải trang ban đầu nhanh, auto-imports giữ code gọn gàng, và Nitro xử lý cả rendering lẫn API routes từ một deployment duy nhất. Ba nền tảng vững chắc để tiếp tục phát triển.
Các bước tiếp theo hợp lý: kết nối Drizzle ORM để truy cập database an toàn với kiểu dữ liệu (tích hợp rất gọn với server utilities của Nitro), thêm xác thực với nuxt-auth-utils, và deploy lên Railway, Render, hoặc VPS chạy PM2. Cả ba đều có tài liệu tốt và không yêu cầu thay đổi lớn những gì bạn đã xây dựng.
Stack này đã chạy production với PostgreSQL backend trên hai site — tổng cộng hơn 50k lượt xem trang mỗi tháng — mà không gặp bất kỳ giới hạn kiến trúc nào. Các quy ước có vẻ hạn chế lúc đầu. Nhưng khi bạn đã ship một thứ gì đó thực sự với chúng, chúng bắt đầu cảm giác như dải phân cách bảo vệ hơn là hàng rào cản.

