苦 Node.js SSR 久矣:我们把技术社区从 Nuxt 3 迁回了纯 Go 架构

我们砍掉了 Nuxt 3,把技术社区重构成了 Go + Templ + HTMX

自从有了 vue, react 之后,前后端分离,后端通过http接口返回json,前端拿到json数据解析并渲染,几乎成了各种web应用的标准做法。

在此基于vue,react 的技术构架之后,又有了服务端渲染框架 nuxt, next

在很多团队的惯性思维里,2026 年做一个需要服务端渲染的web应用,标准答案似乎永远是“前后端分离 + 服务端渲染(SSR)”:后端写一套 JSON API,前端上 Vue/React 全家桶,为了 SEO 再套一层 Node.js 的 SSR 框架,也只有 nuxt, next 可选了

在AI时代,nuxt, next 这种技术,基本上可以废掉了。

为什么这么说呢? 因为最近我在想,为了SEO,其实浏览器要的只是一个html。

直接用 20年前的套模板技术,不是更直接嘛

原因有以下 3 点:

  • 现在代码都是 AI 写了,所谓的不好维护好像不成立了。
  • 模板技术也在进化,也能像写类似react一样,写模板了。
  • 做多主题比较方便。

helloworld.net 最初也是这么干的——后端 Go + 前端 Nuxt 3 做 SSR。

但在跑了一段时间后,我们做了一个在不少人看来“很复古”甚至“开倒车”的决定:

彻底砍掉 Nuxt 3 和 Node.js 运行时,把整个社区重构为 Go + Templ + PostgreSQL + GORM + HTMX + Alpine.js(也就是社区常说的 GOTH 栈)。

重构上线后,服务器内存占用直接降了一个数量级,CI/CD 部署从几分钟缩短到几秒钟,开发一个新功能的链路砍掉了一半。今天复盘一下,为什么对于内容型技术社区,GOTH 栈是对 Nuxt 3 SSR 的一次“降维打击”。

一、 Nuxt 3 很强,但用在技术社区里“太重了”

Nuxt 3 是非常优秀的前端框架,但它真正的主场是高交互度的 Web 应用。对于 helloworld.net 这种80% 都是文章阅读、代码展示、站内搜索和轻度点赞评论的技术社区,Nuxt 3 带来了四个极其折磨人的工程痛点:

  1. 双倍的运行时与运维开销:服务器既要跑 Go 后端,又要常驻 Node.js 进程做 SSR 渲染。流量稍微波动,Node 层的 CPU 和内存就会先吃紧,还得额外维护一套容器保活和 Nginx 反向代理分流。
  2. 前后端“胶水代码”重复劳动:为了渲染一个简单的帖子列表,Go 后端要先查库拼装 JSON 结构体;Nuxt 端拿到 JSON 后,再重写一遍 TypeScript Interface、塞进状态管理,最后渲染成 HTML。加一个字段,前后端跟着改三处。
  3. Hydration(注水)的心智负担:SSR 模式下,只要服务端生成的 DOM 和客户端 Vue 接管时的状态有一丁点不一致(比如时间格式化时区差异、浏览器插件注入节点),控制台就会抛出 Hydration Mismatch 警告,排查起来极其消耗精力。
  4. “杀鸡用牛刀”的构建链路:为了页面上几个点赞按钮和弹窗,引入了庞大的 node_modules、Vite 打包体系和复杂的路由水合逻辑,每次改一行样式都要走一遍漫长的前端构建。

二、 GOTH 栈凭什么能打?四大核心武器拆解

切换到 Go + Templ + PostgreSQL + GORM + HTMX + Alpine.js 后,整套系统收敛成了一个编译好的 Go 单体二进制文件 + 一个 PostgreSQL 数据库。

这四个核心组件各自发挥了不可替代的作用:

1. HTML + HTMX:回归超媒体本质,砍掉 90% 的 JSON API

以前前后端交互,后端吐 JSON,前端写 fetch 拿数据再操作响应式状态。

用上 HTMX 后,我们彻底抛弃了 JSON 中间层——后端直接返回渲染好的原生 HTML 片段。

比如社区里最常用的“文章点赞”功能:

HTML

<!-- 后端直接返回的按钮 HTML 片段 -->
<button 
  hx-post="/posts/1024/like" 
  hx-swap="outerHTML" 
  class="btn-like active">
  👍 已赞 (42)
</button>

用户点击按钮,HTMX 自动发起 POST 请求,并用后448215端返回的新 HTML 片段原地替换掉旧按钮(outerHTML),一行 JavaScript 都不用写。

更爽的是,给全站导航加上 hx-boost="true" 后,多页面应用(MPA)直接拥有了单页应用(SPA)般的无刷新丝滑跳转体验、

同时保留了 100% 原生 HTML 直出对搜索引擎爬虫(SEO)的极致友好,同时页面加载速度也加了很多。

htmx 技术,是绝对被忽略了一个技术,有兴趣的同学可以研究一下。

2. Templ:像写 JSX 一样写类型安全的 Go 模板

很多人抗拒服务端渲染,是因为不管之前的Java技术栈的JSP,还是Go的 html/template,都是把业务和UI参和在一起,

并且模板 语法别扭、没有类型检查,字段名写错要等到线上运行才报错。

Templ 模板完美解决了这个问题——它会在编译期把 .templ 文件直接生成强类型的 Go 代码,零反射、性能极高。

templ 可以像写jsx一样,在模板中,使用用go代码。

在 helloworld.net 中,文章卡片组件可以直接接收 GORM 查出来的结构体:

Go

// blog_card.templ
package components

import "helloworld/models"

templ BlogCard(blog models.blog ) {
	<article class="blog-card" id={ "blog-" + blog.ID }>
		<h3>
			<a href={ templ.SafeURL("/p/" + blog.Slug) } hx-boost="true">
				{ blog.Title }
			</a>
		</h3>
		<p>{ blog.Summary }</p>
		<div class="meta">
			<span>作者:{ blog.Author.Nickname }</span>
			@LikeButton(blog.ID, blog.LikesCount, blog.IsLiked)
		</div>
	</article>
}

如果 blog.Author.Nickname 拼错了,在本地保存/编译阶段 IDE 直接标红报错,彻底告别运行时模板崩溃。

3. Alpine.js:仅 15KB 接管纯前端“微交互”

HTMX 负责与服务端通信,那纯客户端的瞬时交互怎么办?比如代码块的“一键复制”、顶部导航下拉菜单、Markdown 编辑器预览切换、弹窗开关。

这些不需要请求后端的状态,全部交给 Alpine.js。

它不需要 npm install,也不用 Webpack/Vite 打包,只需引入一个十几 KB 的 <script> 标签,就能直接在 HTML 标签上写声明式交互:

HTML,比如 代码块一键复制 代码如下:

<!-- 代码块一键复制,零构建步骤 -->
<div x-data="{ copied: false }" class="code-wrapper">
  <button 
    @click="navigator.clipboard.writeText($refs.code.innerText); copied = true; setTimeout(() => copied = false, 2000)">
    <span x-text="copied ? '✅ 已复制' : '📋 复制代码'"></span>
  </button>
  <pre><code x-ref="code">go build -o helloworld .</code></pre>
</div>

没有虚拟 DOM diff,没有构建编译等待,所写即所得。

4. PostgreSQL 全文索引:省掉独立部署 Elasticsearch

技术社区离不开站内搜索。在旧架构里,我们原本计划引入 Elasticsearch 来做文章检索,但这意味着又要多维护一套吃内存的 JVM 服务。

在重构时,我们直接挖掘了 PostgreSQL 原生的 tsvector 全文检索 + GIN 索引能力,配合 GORM 轻松搞定了站内毫秒级搜索:

SQL

-- 1. 为文章表添加全文检索向量列并建立 GIN 索引
ALTER TABLE blog ADD COLUMN search_vector tsvector
  GENERATED ALWAYS AS (
    setweight(to_tsvector('simple', coalesce(title, '')), 'A') ||
    setweight(to_tsvector('simple', coalesce(content, '')), 'B')
  ) STORED;

CREATE INDEX idx_blog_search ON blog USING GIN (search_vector);

Go

// 2. GORM 中直接利用 @@ 操作符查询并按相关度排序
db.Where("search_vector @@ plainto_tsquery('simple', ?)", keyword).
   Order(gorm.Expr("ts_rank(search_vector, plainto_tsquery('simple', ?)) DESC", keyword)).
   Find(&posts)

不仅实现了“标题权重高于正文”的精准排序,而且数据写入即索引,零同步延迟、零额外中间件运维成本。

配合 HTMX 的 hx-trigger="keyup changed delay:300ms",用户在搜索框输入关键词时,下方直接实时局部刷新出搜索结果列表。

三、 架构切换前后的直观对比

核心维度 旧架构(Go + Nuxt 3 SSR) 新架构(GOTH 栈) 实际收益
部署产物 Go 二进制 + Node.js 服务端包 单个 Go 二进制文件 部署耗时从分钟级降至秒级
类型安全 Go Struct + TS Interface 双份维护 Templ 编译期全链路强类型 砍掉所有接口字段对齐成本
前端交互 Vue 全家桶 + Hydration 注水 HTMX + Alpine.js(~15KB) 彻底告别 Hydration 报错与构建等待
站内搜索 规划引入独立搜索组件 PostgreSQL 原生 GIN 全文索引 零外部依赖,数据强一致

写在最后

技术选型没有银弹,只有适不适合。如果你在做在线设计工具或重度富文本协同,Vue/React 依然是无可替代的霸主;

但如果你正在搭建一个技术社区、博客、文档站或后台管理系统,Go + Templ + PostgreSQL + HTMX + Alpine.js 带来的开发爽感和运维确定性,真的会让你有种 “卸下重甲、轻装上阵”的畅快感,技术构架简单,少了很多心智负担。

个人感觉:很多用 nuxt, next 的项目,基本上可以用这套技术栈替代了

目前这套全新的 GOTH 架构已经在 helloworld.net 正式全量上线。

欢迎大家直接点进网站感受一下 go + templ + htmx + alpine.js + tailwind + pgsql 的实际体验 。

评论

暂无评论