一、 数据库部署 (MySQL)

数据库是项目的核心，必须确保表结构完整且程序有权访问。

1. 创建数据库：

   • 在宝塔面板“数据库”菜单下添加数据库。

   • 记录好数据库名（例：xxx_db）、用户名（例：xxx_db）和密码。

2. SQL 文件预处理：

   • 若导入报错 Access denied，需编辑 data.sql。

   • 删除文件开头包含 CREATE DATABASE 和 USE 的行，确保 SQL 只包含建表和插入数据的指令。

3. 执行导入：

   • 进入 phpMyAdmin，必须先在左侧列表中点击选中目标数据库。

   • 点击“导入”标签，上传并执行修改后的 data.sql。

   • 验证：点击表名（如 video_template），确认右侧出现了数据行。

二、 后端环境配置 (config.yaml)

配置文件决定了程序能否正确识别数据库和外部接口。

1. 数据库连接设置（第 17 行）：

   • 格式：link: "mysql:用户名:密码@tcp(127.0.0.1:xxx)/数据库名?loc=Local"。

   • 注意：用户名和数据库名的大小写必须与宝塔面板显示的完全一致。

2. 微信小程序对接（第 28-30 行）：

   • 填入正确的 appId 和 secret。

   • 白名单配置（第 23-27 行）：将不需要登录即可访问的接口（如 /video/template/list）加入 whiteList。

3. 文件上传路径（第 32 行）：

   • 确保 imgPath 设为物理路径（如 /www/wwwroot/assets）。

   • 权限：在宝塔“文件”管理中，确保该文件夹权限为 755，所有者为 www。

三、 微信小程序后台必要设置

这是解决日志中 Internal Panic（空指针崩溃）的关键步骤。

1. IP 白名单：

   • 登录微信公众平台 -> 开发管理 -> 开发设置。

   • 将服务器公网 IP 120.xx.xx.xx 加入 IP 白名单。

   • 原因：若不加白名单，后端无法通过 API 获取 AccessToken，会导致程序运行时逻辑崩溃。

2. 服务器域名：

   • 在小程序后台“request合法域名”中添加你的 API 域名（如 https://supav.chaoweiaigc.com）。

四、 项目启动与维护

1. 重启服务：

   • 在宝塔“Go项目管理”中，任何配置文件的修改都必须点击 “重启” 才能生效。

2. 状态监控：

   • 通过 “项目日志” 监控运行情况。

   • 若看到 INSERT INTO "video_template" 且无报错，说明数据推送与入库逻辑已彻底打通。

3. 静态资源访问：

   • 在 Nginx 配置文件中添加 location /assets/ { alias /www/wwwroot/assets/; }，确保小程序能正常显示上传的图片。

🛠 故障排查速查表

• 报错 No database selected：在 phpMyAdmin 中导入前未点击左侧数据库名。

• 报错 Internal Panic：通常是由于未配置微信 IP 白名单或 AppSecret 错误。

• 数据库不更新：检查 config.yaml 里的数据库用户名密码是否匹配，并确认是否执行了项目重启。