很多刚接触后端开发的朋友总觉得神秘,其实拆开来看就是一套固定套路。今天咱们就像师傅带徒弟一样,从头捋一遍怎么设计一个能用的 API 接口,再把它部署到服务器上。
先说 API 设计。你接到一个需求,比如要做一个用户登录接口,第一件事不是写代码,而是想清楚这个接口要干什么、收什么参数、返回什么结果。登录接口嘛,肯定需要用户名和密码,返回的就是登录成功还是失败,成功的话给个 token 让用户后续请求带着。参数用 JSON 格式最方便,请求体里放 username 和 password 两个字段。返回结果也要统一格式,比如都用 code 表示状态码,message 放提示信息,data 放实际数据。这样前端对接的时候心里有数,不会猜来猜去。
代码层面,用 Node.js 的 Express 框架举个例子。先装依赖,npm install express,然后写个最简单的服务器。引入 express,创建 app 实例,用 app.post 定义登录接口路径,比如 /api/login。在回调函数里从 req.body 取参数,验证用户名密码,验证通过就生成 token 返回。这里要注意几件事,一是密码不能明文存,要用 bcrypt 加密,二是 token 用 jwt 生成,三是所有接口都要做错误处理,用 try-catch 包起来,出错了返回统一的错误格式。
接口写好了,本地测试没问题,接下来要部署到服务器。买台云服务器,选 Ubuntu 系统,SSH 连上去。第一步装 Node.js,用 nvm 管理版本最灵活,curl 下载 nvm 脚本,source 一下,然后 nvm install 18 装 LTS 版本。代码用 git 拉上去,或者直接用 scp 传。装好 pm2 做进程管理,npm install -g pm2,然后用 pm2 start app.js 启动服务。这时候接口已经能访问了,但用的是服务器 IP 加端口,比如 1.2.3.4:3000,不太好看。
上域名和 HTTPS 才像正式项目。在域名服务商那里把域名解析到服务器 IP,然后装 nginx。apt install nginx,改配置文件,在 sites-available 里新建一个配置,server_name 填你的域名,location / 反向代理到 localhost:3000。用 certbot 申请免费 SSL 证书,apt install certbot python3-certbot-nginx,然后 certbot –nginx 按提示操作,自动帮你配好 HTTPS。重启 nginx,现在你的接口就能通过 https://你的域名/api/login 访问了。
最后说监控和日志。pm2 自带日志管理,pm2 logs 能实时看,pm2 log rotate 配置日志轮转。服务器层面装个 htop 看资源占用,设个 cron 每天凌晨重启服务清理内存。重要接口加监控,用 uptime robot 这类服务定时请求,挂了能收到邮件通知。
后端开发就这么回事,设计接口、写代码、部署上线、加监控。每一步都有成熟工具和最佳实践,照着做就不会出大错。关键是多动手,自己搭一遍比看十篇教程都管用。