大家好，我是 EthanYuan。
近期AI Agent智能体开发任务已全部收尾，顺利迭代完成MVP最小可行产品，当前产品已支持基础人机对话、自主任务规划执行等核心能力。项目功能开发完成后，下一步核心工作便是前后端整体上线部署。
本次部署全程采用微信云托管 Serverless 平台，依托容器化部署方案完成前后端上线，无需自建服务器、零运维压力、按量计费，非常适合个人学习项目与学生开发者。本篇完整记录从环境改造、Docker容器打包、跨域处理到云托管配置的全流程落地实战，同时梳理部署踩坑问题与标准化配置规范。
一、Serverless 核心认知
什么是 Serverless？
Serverless 是轻量化云上部署平台，区别于自行购买搭建的轻量云服务器，服务器维护、环境管理、底层运维全部由云厂商统一负责，开发者只需专注业务代码开发与功能迭代。
平台支持根据项目访问流量自动弹性扩容、闲置时段自动暂停服务，采用按量计费模式，完美适配业务规模不确定、流量波动大的场景，也是个人练手项目低成本部署的最优选择。
Serverless 核心优势
● 低成本部署：对于学生开发者极其友好，传统轻量云服务器每月固定付费，而Serverless闲置无消耗不收费，大幅节约开发成本。
● 节省运维成本：无需配置服务器环境、处理系统漏洞、维护服务常驻，告别繁琐运维，聚焦代码本身实现。
二、后端项目 Serverless 部署流程
1、改造生产环境配置
新建生产环境专属配置文件 application-prod.yml，基于开发环境配置快速复制改造：
- 关闭 Swagger 接口文档，减少线上资源占用与安全隐患
- 替换 MySQL、Redis 等中间件连接地址为线上环境专属地址
通过多环境配置隔离开发、生产环境，避免配置冲突。
2、Docker 容器化基础认知
项目线上部署统一采用 Docker 容器化打包，彻底解决「本地正常、线上报错」的环境兼容问题。
- Docker：容器化技术，将项目代码、第三方依赖、运行环境统一打包为镜像，可在任意支持Docker的平台快速运行，环境一致性拉满。
- Dockerfile：自动化构建镜像的文本配置文件，通过逐条指令定义镜像基础环境、文件复制、项目编译、服务启动规则，是容器打包的核心文件。
3、后端两种打包部署方式对比
- 运行时打包：仅上传项目代码+Dockerfile压缩包，由Serverless平台自动完成依赖下载、项目编译构建。
优点：全程自动化，操作简单；
缺点：平台外网网络受限，容易依赖拉取失败导致部署报错。 - 本地预打包：本地先编译打好Jar包，将Jar包与Dockerfile同级压缩上传。
优点：本地提前验证项目可正常启动，规避编译报错，部署稳定性更高；
缺点：Jar包体积较大，对上传网络稳定性有一定要求。
实际落地测试后，本地预打包更适合个人开发场景，提前本地自测启动，大幅降低线上部署失败概率。
4、标准化后端 Dockerfile 生成方案
针对 Java17 + SpringBoot3 + Maven 技术栈，整理通用AI生成提示词，一键产出可直接用于腾讯云SCF、微信云托管的精简Dockerfile：
请生成一个适用于 Serverless 部署的 Dockerfile，用于后端项目：
1. 技术栈：Java 17 + SpringBoot 3
2. 项目使用 Maven 构建
3. 打包成 jar 运行
4. 暴露端口 8080
5. 使用精简的 alpine 基础镜像
6. 自动下载依赖、编译、打包、运行
7. 适配阿里云函数计算 / 腾讯云 SCF
8. 不要多余配置，直接可用
使用规范：Dockerfile 需与 pom.xml 同级，打包项目根目录为Zip压缩包上传即可。
三、Vue前端容器化部署 & 跨域解决方案
前后端分离架构下，前后端部署为独立域名，线上会直接出现接口跨域拦截问题。本次通过Nginx反向代理容器化方案统一解决跨域、路由刷新404、AI流式对话适配三大问题。
1、自定义 Nginx 代理配置
前端根目录新建 nginx.conf，内置静态资源缓存、Vue路由兼容、后端接口代理、SSE流式传输配置，仅需修改后端服务地址即可直接使用：
server {
listen 80;
server_name localhost;
root /usr/share/nginx/html;
index index.html index.htm;
# Vue 路由刷新 404 问题解决
location / {
try_files $uri $uri/ /index.html;
}
# 后端接口反向代理 仅需修改后端地址
location ^~ /api/ {
proxy_pass https://你的后端地址/api/;
proxy_set_header Host $proxy_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
# SSE 流式输出 适配AI聊天场景
proxy_http_version 1.1;
proxy_buffering off;
proxy_cache off;
proxy_read_timeout 600s;
proxy_set_header Connection "";
}
# 静态资源长效缓存 优化访问速度
location ~* .(js|css|png|jpg|svg|ico|woff2)$ {
expires 30d;
add_header Cache-Control public;
}
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root /usr/share/nginx/html;
}
}
2、前端多阶段构建 Dockerfile
采用分层构建，分离项目编译阶段与Nginx运行阶段，精简最终镜像体积：
# 前端构建阶段
FROM node:20-alpine AS build
WORKDIR /app
COPY . .
RUN npm install
RUN npm run build
# 运行阶段 Nginx托管静态资源
FROM nginx:alpine
COPY --from=build /app/dist /usr/share/nginx/html
COPY nginx.conf /etc/nginx/conf.d/default.conf
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]
3、项目精简优化
同步配置 .dockerignore 文件，忽略 node_modules、缓存文件、日志文件等无关资源，减少压缩包体积，提升部署效率。
四、微信云托管服务标准化配置
1、Redis 轻量化部署
线上缓存服务直接使用官方Redis镜像快速部署：
- 镜像选择：
redis:latest快速拉取 - 资源配置：CPU、内存调整为平台最小规格，控制资源消耗
2、实例数量配置规范（线上稳定运行关键）
● 前端项目：最小实例=1、最大实例=1，保证域名访问即时响应，禁止冷启动延迟
● 后端项目：最小实例=0、最大实例=1，支持闲置暂停、按需冷启动，最大化节约费用
● Redis缓存：最小实例=1、最大实例=1，缓存数据不可中断，避免重启数据丢失
五、部署踩坑问题与解决方案
问题：本地stdio模式正常，线上MCP Server超时报错
- 问题原因：线上Serverless环境网络限制，stdio传输模式不适配公网环境
- 临时方案：暂时禁用MCP服务，优先保障项目公网正常访问；
- 长期方案：改造为SSE流式通信模式，适配线上服务调用规则。
六、总结
本次AI Agent前后端项目，全部基于Docker容器化+微信云托管Serverless完成上线部署，整套方案轻量化、低成本、易复用，不仅完美适配AI智能体这类个人开发项目，也可通用在相册系统、内容社区、管理后台等前后端分离业务中。
容器化部署统一了开发与生产环境，Nginx反向代理标准化解决前后端分离跨域痛点，结合Serverless按量计费、免运维的特性，极大降低了学生开发者的上线门槛。
软件开发从来不止是功能代码编写，容器化、工程化部署、线上环境适配、性能与成本平衡，都是后端开发者必备的核心能力。规范落地部署流程、积累实战踩坑经验，才能写出从本地到线上全链路稳定运行的高质量项目。
