uniCloud云函数可通过mysql2/promise直连公网MySQL，需开放外网访问、配置环境变量、调用connection.end()防超时，并通过参数化查询防SQL注入；前端仅能通过uniCloud.callFunction安全调用。
uniCloud云函数里怎么连外部MySQL
uniCloud本身不提供MySQL服务，但它的云函数是运行在Node.js环境里的，所以可以在云函数中用mysql2这类驱动直连公网可访问的MySQL实例。关键不是“uni-app连MySQL”，而是“uniCloud云函数作为中间层去连”。
- 必须用
mysql2/promise（非mysql），否则await会失效，云函数容易超时 - MySQL服务端必须开放外网访问（绑定
0.0.0.0、放行防火墙端口、授权远程用户），仅localhost或内网IP无效 - 连接后务必调用
connection.end()或connection.destroy()，否则连接堆积导致云函数报timeout或EMFILE - 敏感信息（如密码）不能硬编码，要通过云函数环境变量配置：
process.env.MYSQL_PASSWORD
云函数调MySQL常见报错及修复
真机或模拟器上报错Connection refused、connect ETIMEDOUT、Access denied for user，基本都指向同一类问题。
-
Connection refused：MySQL没开外网端口，或云函数所在区域（阿里云华东1/腾讯云广州）无法路由到你的服务器IP -
Access denied：MySQL用户没授GRANT ALL ON *.* TO 'user'@'%'，只给了@'localhost'权限 -
TypeError: connection.query is not a function：用了mysql包却没调.promise()，正确写法是mysql.createConnection(...).promise() - 本地调试正常、上传后失败：环境变量没同步到云端，HBuilderX右键云函数 →「上传」后，还要手动点「云函数管理」→「编辑环境变量」补全
uni-app前端怎么安全调用MySQL数据
前端永远不能暴露数据库连接细节，所有查询必须封装在云函数里，uni-app只调uniCloud.callFunction。
- 不要在
onLoad里直接uni.request访问你自己的Node.js后端（除非你额外部署了独立服务），那样绕过了uniCloud统一鉴权和流量控制 - 云函数入口参数要校验，比如
event.id是否为数字、event.table是否在白名单内，防止SQL注入或越权读取 - 避免在云函数里拼接SQL字符串，优先用参数化查询：
connection.execute('SELECT * FROM user WHERE id = ?', [event.id]) - 返回给前端的数据建议用
JSON.stringify再JSON.parse过一遍，过滤掉Buffer、Date等不可序列化字段，否则小程序里会报Converting circular structure to JSON
为什么不用uniCloud云数据库而选MySQL
这不是技术偏好问题，而是业务约束决定的——当你已有现成MySQL库、需事务/JOIN/视图/存储过程，或已有DBA运维体系时，强行迁移到MongoDB成本极高。
- uniCloud云数据库（MongoDB）不支持
JOIN、跨集合事务、唯一索引约束（部分版本支持但限制多），复杂关联查得自己写聚合管道，开发效率低 - MySQL的
utf8mb4字符集、全文索引、GIS函数等特性，在MongoDB里要么没有，要么实现方式完全不同 - 如果你的MySQL跑在阿里云RDS或腾讯云CVM上，云函数直连延迟通常
- 注意：云函数冷启动约300–800ms，高频请求建议加Redis缓存层，别让每次调用都穿透到MySQL
真正卡住人的从来不是代码怎么写，而是MySQL外网权限配了几遍、云函数环境变量传没传上去、连接池没关导致第二天整个服务空间被限频。这些地方一漏，日志里就只剩function timeout四个字，再好看的SQL也跑不起来。
