戰(zhàn):打造端到端類型安全的全棧應(yīng)用)
我起項(xiàng)目代號很隨意但工具鏈一點(diǎn)都不隨意。t3code這個(gè)項(xiàng)目名來自我去年在團(tuán)隊(duì)內(nèi)部做技術(shù)分享時(shí)隨手起的代號——t3取自T3 Stackcode則因?yàn)檎麄€(gè)項(xiàng)目從數(shù)據(jù)層到界面層全部圍繞類型安全的代碼鏈路展開。說白了t3code就是我基于TypeScript、Next.js、tRPC、Prisma、Tailwind這套組合從零搭起來的一個(gè)全棧Web應(yīng)用示例項(xiàng)目用來驗(yàn)證“端到端類型安全”到底能在真實(shí)業(yè)務(wù)里省多少事。如果你正打算選型一套前后端分離但又不愿意維護(hù)雙端類型定義的項(xiàng)目或者想看看T3 Stack在實(shí)際落地時(shí)有哪些坑和細(xì)節(jié)這篇就當(dāng)一次同事間的技術(shù)復(fù)盤看。我會把項(xiàng)目的設(shè)計(jì)思路、核心鏈路、實(shí)操步驟以及我踩過的真實(shí)問題全部鋪開講代碼片段可以直接拿去改。1. 項(xiàng)目整體設(shè)計(jì)與技術(shù)選型1.1 為什么選T3 Stack這套組合先說結(jié)論T3 Stack不是框架不是官方發(fā)布的東西它是一套由社區(qū)主導(dǎo)的最佳實(shí)踐組合。核心哲學(xué)很直白——能不用JavaScript的地方就不用JavaScript全部換TypeScript讓類型從數(shù)據(jù)庫一直灌到瀏覽器里。我在做t3code之前用過常規(guī)的REST API方案寫過GraphQL方案也試過純服務(wù)端渲染加少量交互的方案但總會遇到同一個(gè)毛病改了后端字段前端要手動(dòng)同步類型定義漏一次就是線上運(yùn)行時(shí)才發(fā)現(xiàn)Bug。T3 Stack恰好解決了這個(gè)痛點(diǎn)。它把Next.js當(dāng)應(yīng)用骨架Prisma做數(shù)據(jù)庫映射tRPC替代REST和GraphQLNextAuth做認(rèn)證Tailwind負(fù)責(zé)樣式最后用TypeScript把所有環(huán)節(jié)粘起來。從Prisma的model定義出發(fā)類型直接推導(dǎo)到tRPC的返回值再通過React Query的hooks傳到組件props全程你不寫一行手動(dòng)的interface編輯器都能給你提示字段錯(cuò)誤。這對一個(gè)以“少寫重復(fù)代碼”為目標(biāo)的項(xiàng)目來說幾乎是降維打擊。選它還有一個(gè)實(shí)際原因社區(qū)生態(tài)足夠成熟。T3相關(guān)的關(guān)鍵詞在GitHub上能搜出大量模板和討論遇到問題有現(xiàn)成的排查思路不像某些新興框架連文檔都不全。t3code的定位是“生產(chǎn)級示例”所以我更看重穩(wěn)定性和可維護(hù)性而不是炫技。1.2 技術(shù)棧逐項(xiàng)拆解與分工t3code用到的核心依賴如下模塊選型職責(zé)框架Next.js 14App Router模式服務(wù)端渲染、路由、API層承載語言TypeScript 5.x全鏈路靜態(tài)類型檢查數(shù)據(jù)庫ORMPrisma 5.x數(shù)據(jù)建模、遷移、查詢RPC層tRPC 10.x前后端類型安全的API調(diào)用數(shù)據(jù)請求TanStack Query 5.x緩存的client端狀態(tài)管理認(rèn)證NextAuth.jsAuth.js登錄會話與OAuth授權(quán)樣式Tailwind CSS 3.x原子化CSS與響應(yīng)式布局這個(gè)分工最舒服的地方在于每個(gè)工具都只管自己最擅長的事Next.js負(fù)責(zé)渲染與路由的框架邏輯Prisma不碰業(yè)務(wù)邏輯只做數(shù)據(jù)映射tRPC不代替業(yè)務(wù)框架只做類型安全的函數(shù)調(diào)用Tailwind不管數(shù)據(jù)只負(fù)責(zé)樣式。層與層之間的邊界非常干凈定位問題的時(shí)候能快速縮小范圍。1.3 腳手架初始化與工程規(guī)范t3code初始化用的是Create T3 App的標(biāo)準(zhǔn)命令npm create t3-applatest t3code交互式選項(xiàng)里我按項(xiàng)目需要勾選了Next.js、Tailwind、tRPC、Prisma、NextAuth把ESLint也帶上。初始化完目錄結(jié)構(gòu)已經(jīng)有了基礎(chǔ)的“三段式”分層src/ app/ // Next.js App Router的頁面與布局 server/ // api路由、auth配置、db實(shí)例、tRPC根路由 trpc/ // tRPC的客戶端封裝與server返回類型 prisma/ schema.prisma // 數(shù)據(jù)模型定義這里有個(gè)容易忽略的細(xì)節(jié)Create T3 App生成的項(xiàng)目默認(rèn)使用嚴(yán)格模式的TypeScript配置noUncheckedIndexedAccess也是開的。這意味著你不能隨便用array[0]而不處理undefined。剛開始會有點(diǎn)煩但適應(yīng)之后代碼質(zhì)量確實(shí)高了不少很多運(yùn)行時(shí)錯(cuò)誤在設(shè)計(jì)期就被堵住了。2. 核心鏈路類型安全的數(shù)據(jù)流設(shè)計(jì)2.1 Prisma數(shù)據(jù)建模與遷移策略t3code的業(yè)務(wù)模型我設(shè)計(jì)得比較簡單——模擬一個(gè)帶用戶系統(tǒng)的內(nèi)容管理場景有User、Post、Comment三個(gè)核心實(shí)體。先看最關(guān)鍵的Prisma schemamodel User { id String id default(cuid()) name String? email String unique emailVerified DateTime? image String? posts Post[] comments Comment[] createdAt DateTime default(now()) updatedAt DateTime updatedAt } model Post { id String id default(cuid()) title String content String published Boolean default(false) author User relation(fields: [authorId], references: [id]) authorId String comments Comment[] createdAt DateTime default(now()) updatedAt DateTime updatedAt } model Comment { id String id default(cuid()) content String post Post relation(fields: [postId], references: [id], onDelete: Cascade) postId String author User relation(fields: [authorId], references: [id]) authorId String createdAt DateTime default(now()) }我選擇cuid()作為主鍵而不是自增整數(shù)主要是考慮到數(shù)據(jù)可能在多個(gè)環(huán)境間遷移、合并CUID能避免沖突。值得注意的是外鍵關(guān)系一定要明確寫onDelete策略。比如評論關(guān)聯(lián)帖子帖子刪除時(shí)評論應(yīng)該一起刪這里就配置了onDelete: Cascade否則數(shù)據(jù)庫層面會限制刪除操作業(yè)務(wù)里就要額外寫清理邏輯。遷移我習(xí)慣用prisma migrate dev在本地開發(fā)生產(chǎn)環(huán)境則用prisma migrate deploynpx prisma migrate dev --name init_t3code npx prisma migrate deploy2.2 tRPC路由劃分與類型推導(dǎo)機(jī)制tRPC的核心思想是后端導(dǎo)出的router類型前端直接就能推斷出來。t3code的tRPC架構(gòu)是標(biāo)準(zhǔn)的“根路由聚合子路由”模型// src/server/api/root.ts export const appRouter router({ post: postRouter, user: userRouter, comment: commentRouter, }); export type AppRouter typeof appRouter;每個(gè)子路由內(nèi)部再拆procedure// src/server/api/routers/post.ts import { z } from zod; import { createTRPCRouter, protectedProcedure, publicProcedure } from ../trpc; export const postRouter createTRPCRouter({ all: publicProcedure.query(async ({ ctx }) { return ctx.db.post.findMany({ where: { published: true }, orderBy: { createdAt: desc }, include: { author: { select: { name: true, image: true } } }, }); }), byId: publicProcedure .input(z.object({ id: z.string() })) .query(async ({ ctx }) { return ctx.db.post.findUnique({ where: { id: input.id }, include: { comments: { include: { author: true } } }, }); }), create: protectedProcedure .input(z.object({ title: z.string().min(1), content: z.string().min(1) })) .mutation(async ({ ctx, input }) { return ctx.db.post.create({ data: { title: input.title, content: input.content, authorId: ctx.session.user.id }, }); }), });注意這里的publicProcedure和protectedProcedure是區(qū)分權(quán)限的關(guān)鍵。t3code在createTRPCContext里注入了當(dāng)前session若用戶未登錄protectedProcedure會直接拋401前端拿到錯(cuò)誤后就能跳轉(zhuǎn)登錄頁。這樣的好處是權(quán)限控制不再散落在每個(gè)API handler里而是通過“中間件”統(tǒng)一治理。2.3 client端React Query的自動(dòng)生成與緩存tRPC最爽的使用體驗(yàn)在前端。初始化時(shí)通過createTRPCReact創(chuàng)建hooks類型自動(dòng)從AppRouter推導(dǎo)// src/trpc/react.tsx import { createTRPCReact } from trpc/react-query; export const api createTRPCReactAppRouter();頁面里直接用const { data, refetch } api.post.all.useQuery(); const createPost api.post.create.useMutation({ onSuccess: () { utils.post.all.invalidate(); }, });useMutation的onSuccess里調(diào)用invalidate()刪除或創(chuàng)建數(shù)據(jù)后自動(dòng)觸發(fā)相關(guān)查詢的重新拉取。這是React Query最核心的緩存機(jī)制幾乎不用手動(dòng)管理loading狀態(tài)比手工寫fetch然后自己setState要省太多。建議新手重點(diǎn)理解失效invalidate和緩存命中兩個(gè)概念這是和傳統(tǒng)fetch方案最大的分水嶺。3. 實(shí)操過程與核心環(huán)節(jié)實(shí)現(xiàn)3.1 認(rèn)證模塊NextAuth接入與自定義登錄t3code默認(rèn)集成了NextAuth但要讓它跑起來有幾個(gè)必填環(huán)境變量DATABASE_URLpostgresql://... NEXTAUTH_SECRET生成一串隨機(jī)字符串 NEXTAUTH_URLhttp://localhost:3000我強(qiáng)烈建議用openssl rand -base64 32生成NEXTAUTH_SECRET不要自己編一個(gè)短字符串否則生產(chǎn)環(huán)境會告警。NextAuth的配置集中在src/server/auth.tsexport const authOptions: NextAuthOptions { providers: [ GitHubProvider({ clientId: process.env.GITHUB_CLIENT_ID!, clientSecret: process.env.GITHUB_CLIENT_SECRET!, }), ], callbacks: { session({ session, user }) { return { ...session, user: { ...session.user, id: user.id } }; }, }, };理論上到這里GitHub登錄就能用了但實(shí)際落地時(shí)還有一個(gè)坑NextAuth默認(rèn)的session類型里沒有user.id需要自己擴(kuò)展類型聲明。我會在src/types/next-auth.d.ts里寫declare module next-auth { interface Session { user: { id: string; name?: string | null; email?: string | null; image?: string | null; }; } }不補(bǔ)這個(gè)類型ctx.session.user.id在tRPC里會直接報(bào)類型錯(cuò)誤。這個(gè)細(xì)節(jié)教程里很少提到但幾乎所有基于NextAuth tRPC的項(xiàng)目都會遇到。3.2 核心頁面與SSR數(shù)據(jù)加載策略t3code里我寫了三個(gè)主要頁面首頁帖子列表、單個(gè)帖子詳情、個(gè)人中心。每個(gè)頁面的數(shù)據(jù)加載策略不一樣這是Next.js App Router模式下需要仔細(xì)權(quán)衡的點(diǎn)。首頁用服務(wù)端組件直接調(diào)tRPC是不行的因?yàn)锳pp Router的服務(wù)端組件不能直接使用基于React Query的tRPC hooks。正確做法是調(diào)用tRPC的server端函數(shù)// src/app/page.tsx import { api } from ~/trpc/server; export default async function HomePage() { const posts await api.post.all.query(); return PostList initialPosts{posts} /; }詳情頁則可以在Server Component里通過動(dòng)態(tài)路由參數(shù)調(diào)用api.post.byId.query({ id })這樣首屏HTML直接包含完整數(shù)據(jù)SEO友好不用客戶端再等一個(gè)loading。個(gè)人中心需要登錄后展示自己的帖子這種情況我選擇“混合策略”外殼用Server Component判斷session內(nèi)部交互組件用Client Component tRPC query。這個(gè)邊界要分清楚Server Component負(fù)責(zé)首屏靜態(tài)數(shù)據(jù)Client Component負(fù)責(zé)需要交互的查詢和mutation。3.3 環(huán)境變量管理與多環(huán)境部署t3code用了三個(gè)環(huán)境文件來管理不同階段的配置.env.example # 模板提交到倉庫 .env.development # 本地開發(fā) .env.production # 線上部署一個(gè)重要的安全習(xí)慣.env.example里只寫鍵名和占位符真正的密鑰永遠(yuǎn)不要提交到Git倉庫。我在項(xiàng)目根目錄放了.gitignore默認(rèn)會忽略所有.env*但如果你把.env.example也忽略了隊(duì)友拉代碼就會一臉懵。建議做兩件事保留.env.example進(jìn)倉庫手動(dòng)在.gitignore里加一行!.env.example。生產(chǎn)部署我用的是Vercel Postgres托管Vercel平臺對Next.js的支持確實(shí)省心連接數(shù)據(jù)庫只需要在平臺環(huán)境變量面板里把DATABASE_URL和兩個(gè)認(rèn)證密鑰填上。如果要部署到自建服務(wù)器則用Dockerfile構(gòu)建FROM node:20-alpine AS base RUN npm i -g pnpm WORKDIR /app FROM base AS deps COPY package.json pnpm-lock.yaml ./ RUN pnpm install --frozen-lockfile FROM base AS build COPY --fromdeps /app/node_modules ./node_modules COPY . . RUN pnpm prisma generate pnpm build FROM node:20-alpine AS runner COPY --frombuild /app/.next/standalone ./ COPY --frombuild /app/.next/static ./.next/static CMD [node, server.js]Docker部署時(shí)務(wù)必注意Prisma的query engine是平臺相關(guān)的二進(jìn)制在alpine鏡像里需要額外安裝openssl兼容層否則跑起來報(bào)錯(cuò)Query engine library for current platform linux-musl could not be found。如果你不想折騰原生依賴直接用Vercel這類托管平臺能省掉這個(gè)煩惱。4. 常見問題與排查技巧實(shí)錄4.1 tRPC調(diào)用報(bào)500錯(cuò)誤但日志空白這是我在t3code開發(fā)中遇到最多的一類問題。tRPC的錯(cuò)誤處理默認(rèn)會把具體錯(cuò)誤信息藏在response里但如果你開了Next.js的production模式日志里可能只顯示一行Error: Internal Server Error看不到stack trace排錯(cuò)效率極低。排查思路分三步走。先看network響應(yīng)體的error.data字段tRPC會把錯(cuò)誤堆棧放在data.stack里。如果響應(yīng)體也是空的那就去服務(wù)端日志里找Prisma的查詢報(bào)錯(cuò)。還有一個(gè)高頻原因在Server Component里直接調(diào)api.post.all.query()時(shí)忘記給context傳入session導(dǎo)致ctx.session為null。解決方法是給createTRPCContext里做空值兜底export const createTRPCContext (opts: CreateNextContextOptions) { const session getServerSession(authOptions); return { db, session: session ?? null }; };然后protectedProcedure內(nèi)部通過middleware拋錯(cuò)而不是在context構(gòu)建階段就崩潰。這樣至少錯(cuò)誤信息能正確分類為UNAUTHORIZED而不是籠統(tǒng)的500。4.2 Prisma migrate產(chǎn)生歷史分叉多人協(xié)作時(shí)如果你本地的_prisma_migrations歷史記錄和主線不一致prisma migrate dev會報(bào)“migration history is diverged”。我實(shí)操中的快速處理方式是確認(rèn)數(shù)據(jù)庫當(dāng)前狀態(tài)沒問題保存現(xiàn)有數(shù)據(jù)后重置遷移記錄npx prisma migrate reset --force --skip-seed npx prisma migrate dev但reset會清空數(shù)據(jù)所以在非本地環(huán)境千萬別直接跑這條命令。更穩(wěn)妥的做法是刪掉本地prisma/migrations目錄里多余的歷史遷移文件只保留與生產(chǎn)一致的基線再重新生成一個(gè)合并遷移。另外生產(chǎn)環(huán)境數(shù)據(jù)庫我一般會額外做每日備份保證出問題時(shí)能回滾。4.3 Tailwind響應(yīng)式樣式不生效Tailwind的類名在t3code里偶爾會出現(xiàn)“編譯了但樣式?jīng)]生效”的情況。最常見的原因是把動(dòng)態(tài)拼接的類名寫進(jìn)了模板字符串比如className{bg-${color}-500}。Tailwind的掃描器在構(gòu)建時(shí)靜態(tài)識別類名字符串動(dòng)態(tài)拼接的類名會被直接跳過不會生成對應(yīng)CSS。解決辦法是使用完整的類名映射表const colorClasses { red: bg-red-500 hover:bg-red-600, blue: bg-blue-500 hover:bg-blue-600, }; button className{colorClasses[color]} /另外一個(gè)容易踩的坑是App Router里給服務(wù)端組件賦值use client組件或者反過來。如果你在layout.tsx里用了一個(gè)Client Component包裹內(nèi)容且這個(gè)Client Component沒有匹配好SSR和客戶端渲染條件會出現(xiàn)首屏FOUC閃白。t3code里我把所有“需登錄才顯示”的導(dǎo)航區(qū)塊單獨(dú)隔離成Client Component避免把整個(gè)layout強(qiáng)行標(biāo)記成客戶端渲染。4.4 生產(chǎn)環(huán)境首屏接口過慢與緩存優(yōu)化t3code上線內(nèi)測時(shí)發(fā)現(xiàn)帖子列表頁的首屏加載在弱網(wǎng)環(huán)境下需要2秒以上。排查后定位到兩個(gè)瓶頸一是首頁query串行請求了作者信息二是沒有做靜態(tài)緩存。優(yōu)化方案是Prisma查詢里用select按需取字段避免include整張關(guān)聯(lián)表include: { author: { select: { name: true, image: true }, // 只取需要字段 }, }同時(shí)對于“按時(shí)間排序的文章列表”這類很少變化的接口我在Next.js里聲明了revalidate 60讓頁面每分鐘增量重新生成一次靜態(tài)結(jié)果。tRPC的server調(diào)用本身不受影響但Next.js緩存層就能把大部分請求擋住200并發(fā)壓測下響應(yīng)時(shí)間從1.8秒降到了200毫秒左右。注意如果用cookies()或headers()讀取請求上下文Next.js會自動(dòng)禁用靜態(tài)緩存所以“純公開數(shù)據(jù)”的部分才適合加revalidate。4.5 常見問題速查表現(xiàn)象直接原因快速解法類型報(bào)錯(cuò)Property id does not exist on type Session沒有擴(kuò)展NextAuth類型聲明添加next-auth.d.ts并覆蓋Session接口Prisma報(bào)Environment variable not found: DATABASE_URL環(huán)境變量未加載檢查.env文件位置是否在項(xiàng)目根目錄重新sourcetRPC mutation成功但頁面不更新缺少invalidate操作在mutation的onSuccess里調(diào)用相關(guān)的invalidate()Tailwind類名顏色不生效動(dòng)態(tài)拼接類名改成完整類名映射表部署到Docker后Prisma engine報(bào)錯(cuò)alpine缺少平臺依賴用slim鏡像或安裝openssl兼容層NextAuth登錄后session為空NEXTAUTH_SECRET未配置設(shè)置32字節(jié)以上的隨機(jī)字符串5. 一條龍上線的完整復(fù)盤5.1 開發(fā)階段容易忽略的配置細(xì)節(jié)如果你準(zhǔn)備完整照著t3code的思路復(fù)刻有四個(gè)配置細(xì)節(jié)我建議從一開始就做對。第一tsconfig.json里打開strict和noUncheckedIndexedAccess雖然前期會多寫很多空值判斷但等代碼規(guī)模上來之后這個(gè)決定能幫你擋住大量邊界Bug。第二ESLint配置里加上typescript-eslint的推薦規(guī)則t3code的腳手架默認(rèn)帶了別手滑刪掉。它能在你寫異步邏輯時(shí)提示未處理Promise這類錯(cuò)誤在運(yùn)行時(shí)往往最難定位。第三Prisma的url使用connection pooler還是直連要提前想清楚。我踩過的坑是在Serverless環(huán)境用直連Postgres短連接被數(shù)據(jù)庫拒絕。如果是Vercel Postgres一定要把DATABASE_URL配置成連接池地址否則并發(fā)請求一多就會報(bào)連接數(shù)超限。第四所有需要登錄的tRPC mutation入?yún)⒗锒疾灰湃吻岸藗鱽淼膗serId必須從ctx.session.user.id拿。t3code一開始我在一個(gè)更新資料的mutation里直接把前端userId作為設(shè)置項(xiàng)測試時(shí)發(fā)現(xiàn)可以任意改別人數(shù)據(jù)后來全部改成了session取值。這個(gè)原則要寫進(jìn)團(tuán)隊(duì)規(guī)范。5.2 代碼組織與團(tuán)隊(duì)協(xié)作方式t3code項(xiàng)目規(guī)模并不大但代碼組織我刻意按照“可擴(kuò)展”的方式規(guī)劃。tRPC路由器的目錄命名直接對標(biāo)業(yè)務(wù)模塊比如postRouter對應(yīng)整個(gè)帖子模塊頁面組件命名和路由保持一致。這樣加到第三個(gè)業(yè)務(wù)模塊時(shí)只需新開一個(gè)router文件改一下root.ts聚合即可完全不影響已有功能。同類型項(xiàng)目協(xié)作時(shí)我見過團(tuán)隊(duì)糾結(jié)“到底用React Query還是SWR”“用zod還是yup”。實(shí)際體驗(yàn)下來tRPC官方綁定的React Query和zod已經(jīng)是一套非常順手的組合不要在中途替換。因?yàn)閦od不僅僅做入?yún)⑿r?yàn)它的類型推導(dǎo)能力直接被tRPC用來生成procedure的入?yún)㈩愋蛽Q掉yup就等于放棄了這個(gè)核心鏈路的類型安全。5.3 項(xiàng)目上線后我要干什么t3code這個(gè)項(xiàng)目上線后我第一件事是注冊了日志監(jiān)控和錯(cuò)誤上報(bào)服務(wù)。tRPC的錯(cuò)誤默認(rèn)會以TRPCClientError結(jié)構(gòu)被前端捕獲但這些只能看到“用戶視角的錯(cuò)誤”服務(wù)端堆棧對用戶沒有意義需要自動(dòng)上報(bào)到后臺。我接入了錯(cuò)誤捕獲服務(wù)后很快就發(fā)現(xiàn)了一個(gè)“評論創(chuàng)建成功但頁面數(shù)據(jù)不刷新”的問題用戶反饋前就已經(jīng)通過日志定位到了——又是invalidate調(diào)用順序?qū)戝e(cuò)了把這個(gè)操作放在了mutate之后立即執(zhí)行但API請求還沒完全落地。按照我的經(jīng)驗(yàn)項(xiàng)目上線后的前兩周是最容易暴露問題的階段。那些開發(fā)環(huán)境重現(xiàn)不了、從用戶側(cè)看到的偶發(fā)問題90%都是環(huán)境變量缺失、依賴版本不一致、數(shù)據(jù)庫權(quán)限不夠這類“基礎(chǔ)配置”問題而不是業(yè)務(wù)邏輯問題。所以t3code的部署腳本里我用GitHub Actions把所有代碼質(zhì)量檢查、Prisma migrate deploy、構(gòu)建產(chǎn)物串到了一起合并到main分支時(shí)自動(dòng)跑一遍配置錯(cuò)了會在構(gòu)建階段就攔下來。5.4 后續(xù)可以擴(kuò)展的方向t3code現(xiàn)在跑得挺穩(wěn)但我心里有個(gè)擴(kuò)展清單。短期計(jì)劃是加上文件上傳圖片存在對象存儲里數(shù)據(jù)庫只保存訪問路徑Prisma的字段類型改成String前端用帶簽名的URL訪問。中期計(jì)劃是加一個(gè)基于角色的權(quán)限管理在session里注入role字段tRPC procedure里加一個(gè)requireRole(admin)中間件對評論審核、內(nèi)容刪除等操作做權(quán)限控制。長期計(jì)劃是把server端抽成獨(dú)立的BFF服務(wù)和移動(dòng)端共享同一套tRPC路由真正做到一套類型定義覆蓋Web和App兩端。這些方向都是t3code現(xiàn)在這個(gè)架構(gòu)天然支持的因?yàn)轭愋桶踩牡鬃哟蚝昧思庸δ懿辉偈恰罢迟N代碼修類型錯(cuò)誤”而是“寫好業(yè)務(wù)邏輯讓類型檢查替你兜底”。這也是我做完這個(gè)項(xiàng)目后最大的體會投資在數(shù)據(jù)鏈路的類型安全上比任何測試補(bǔ)充都更能長期受益。最后再分享一個(gè)小技巧t3code項(xiàng)目的package.json里我加了一個(gè)db:studio的腳本本地開發(fā)時(shí)一鍵啟動(dòng)Prisma Studio可以直接瀏覽和修改數(shù)據(jù)庫數(shù)據(jù)。調(diào)試數(shù)據(jù)相關(guān)問題時(shí)這個(gè)工具比寫一堆腳本高效得多。如果你是第一次嘗試T3 Stack組合建議先把整個(gè)鏈路跑通一遍——從創(chuàng)建模型、遷移數(shù)據(jù)庫、查詢數(shù)據(jù)到在頁面上渲染出來走完這一步你對這套組合的信心會翻倍。