Cursor实战：UniApp图片管理模块从SQLite迁移到MySQL全过程

前言

在将UniApp项目从SQLite迁移到MySQL的过程中，图片管理模块是一个关键环节。本文记录了使用Cursor AI辅助完成图片管理功能迁移的完整过程，包括接口定义、路由配置、前端页面改造以及调试排错的实战经验。通过这个案例，可以看到AI编程工具在实际项目迁移中的能力边界，同时也整理了一些常见的坑和注意事项。

接口与路由的准备工作

复用分类模块的代码结构

完成分类模块的迁移之后，图片管理模块的开发可以沿用相同的套路。由于图片管理是一个全新的接口，需要重新定义验证器、控制器和路由。

实际操作中，最高效的方式是直接复制分类模块的代码作为基础模板，然后进行针对性修改。需要注意的是，分类模块中可能存在一些图片模块不需要的字段，比如"是否推荐"功能——在检查原始数据表后发现图片表并没有这个字段，因此需要在控制器和接口中将其去掉。

路由配置的细节陷阱

路由定义是最容易出错的环节之一。在本次实战中，就遇到了一个典型问题：路由路径中漏掉了复数形式的"s"。例如将photos写成了photo，导致反复出现"路由不存在"的错误。

这里Cursor展现了不错的智能提示能力——当你输入时，它会自动补全正确的路径，只需按下Tab键即可完成。这个细节提醒我们：即使有AI辅助，路由命名规范的一致性仍然需要人工把关。

使用Cursor同时改造多个文件

让AI理解项目上下文

这次尝试了一个更高效的方式：同时让Cursor修改列表页和添加页两个文件。通过向Cursor描述需求，让它根据已有的接口定义自动识别需要修改的内容。

实际效果相当不错。Cursor能够：

• 自动识别出分类接口尚未接入，并主动补充分类相关代码
• 正确处理二级分类的数据结构
• 将SQLite的本地查询逻辑替换为MySQL的远程API调用

AI改代码与人工改代码的对比

这里有一个深刻的体会：如果让人工来做这种模块迁移，不仅耗时长，而且极易出错。每个文件中涉及的字段名、接口路径、参数格式都需要逐一核对。而Cursor能够基于上下文理解，一次性完成大部分修改工作。

当然，AI也不是万能的。在本次实战中，Cursor生成的代码仍然存在一些未修改到位的地方，比如某些变量名没有从分类模块的命名改为图片模块的命名，这些都需要人工检查和修正。

调试过程中的常见问题与解决方案

问题一：未定义方法错误

添加图片时遇到"未定义"错误，原因是部分方法名还停留在分类模块的命名。解决方式很简单——Cursor的Tab补全功能可以快速修正这些遗漏。

问题二：列表数据为空

添加成功后列表却不显示数据，这是一个比较棘手的问题。排查过程如下：

1. 确认接口本身是否正常：通过直接请求API，确认后端返回了正确数据
2. 检查请求参数：打印前端发送的请求参数，发现分页参数未正确传递
3. 检查数据解析路径：前端代码中数据的取值路径（如rows.rows.data）需要与后端返回格式匹配

最终定位到问题是分页配置未正确添加，补上分页参数后数据正常加载。

问题三：热更新不生效

在修改代码后，有时候应用并不会自动重新编译，导致修改看似没有生效。这种情况下需要：

• 确认文件已保存（Ctrl+S）
• 手动触发重新编译
• 检查编译是否通过，有报错的地方需要先修复

这个问题在开发过程中反复出现，虽然不是技术难题，但确实增加了调试的时间成本。

功能验证与测试清单

完成所有修改后，逐一验证了图片管理的各项功能：

功能	测试结果
图片添加（含分类选择）	✅ 正常
图片列表展示	✅ 正常
按分类搜索	✅ 正常（修复参数后）
图片编辑	✅ 正常
单个删除	✅ 正常
批量删除	✅ 正常
文件名称搜索	✅ 正常
显示状态切换	✅ 正常

其中分类搜索最初不生效，原因是前端传递的参数字段名（PID）与后端期望的不一致，修正后功能正常。

实战总结与经验复盘

Cursor在数据库迁移中的优势

1. 上下文理解能力强：能够根据已有的接口定义和代码模式，自动推断需要修改的内容
2. Tab补全提升效率：对于遗漏的变量名、路径等，一个Tab键即可修正
3. 批量修改能力：可以同时处理多个文件的改造，大幅提升迁移效率

使用AI编程工具需要注意的地方

1. 不能完全依赖AI：生成的代码仍需人工审查，特别是字段名、路径等细节
2. 保存和编译确认：修改后务必确认保存并触发编译，否则容易误判问题
3. 接口调试优先隔离：当前端数据异常时，优先通过直接请求API来判断问题出在前端还是后端
4. 命名规范要统一：路由中的单复数、大小写等细节容易被忽略，需要格外注意

从SQLite到MySQL的迁移，本质上是将本地数据操作替换为远程API调用。借助Cursor这样的AI编程工具，这个过程可以从"逐行修改"变为"描述需求+审查结果"，开发效率提升明显。对于类似的模块化迁移任务，建议先完成一个模块作为模板，后续模块就可以借助AI快速复制和调整。