简介这份资源围绕 JavaScript 直接访问 MySQL 数据库展开面向从事 AJAX 开发、希望省去后台服务与复杂 JDBC 调用的前端与全栈开发者。核心是 JSDBCJavaScript DataBase Connector组件通过 OCX 对象在浏览器端建立与 MySQL 的连接涵盖 connectMySQL、insertMySQL、execDMLMySQL、selectMySQL、deleteMySQL、updateMySQL、callProduceMySQL 等函数用法并给出 getLastError 错误处理与 closeMySQL 释放连接的完整脚本示例同时说明其可扩展支持 SQLite、ACCESS 等数据库。资源包共 1 个 doc 文档约 31KB内容精炼适合作为接口速查与调试参考。目前已有 6926 人学习下载读者可据此快速掌握免部署 Java 环境、免写复杂 JDBC 的数据库直连思路理解查询结果按行与字段分隔符解析为二维数组的处理方式并借鉴其错误捕获与连接关闭的写法用于调试或轻量应用集成。1. JS 直接访问 MySQL为什么大多数前端方案一开始就走错了路浏览器里跑着一段 JS想直接连上 MySQL 把数据读出来——这个念头几乎每个写过前端的人都动过。页面要展示订单、要渲染报表、要做个内部小工具数据明明就在那台数据库服务器上为什么非得绕一层后端接口于是有人去搜「JS 直接访问数据 Mysql」搜出来的答案往往两极分化一边说「用 Node.js 的 mysql2 包就行」另一边说「浏览器里绝对不行」。这两句话其实都对只是说的不是同一件事。关键分歧点在于 JS 的运行位置。跑在浏览器里的 JS受同源策略和沙箱限制只能发 HTTP/WebSocket 这类应用层请求根本拿不到 TCP 层去跟 MySQL 的 3306 端口握手而跑在 Node.js、Deno 或者 Electron 主进程里的 JS本质是服务端运行时有完整的 socket 能力连 MySQL 完全可行。所以「JS 直接访问 MySQL」真正能落地的形态是 Node.js 侧的直连而不是浏览器侧的直连。这篇文章就围绕这个能跑通的形态展开怎么装驱动、怎么建连接池、参数怎么调、事务怎么写、踩过的坑在哪。适合手里有台 MySQL、想用 JS 快速搭数据层或内部工具的开发者也适合被「前端直连数据库」这个说法绕晕、想搞清楚边界的人。2. 选对驱动与运行环境mysql2 凭什么取代了 mysql2.1 为什么是 Node.js 侧直连而不是浏览器先把边界钉死。浏览器里的 JS 没有裸 TCP 能力任何声称「浏览器 JS 直连 MySQL」的方案底下要么是 WebSocket 网关转发要么是某个中间服务在替你连——那已经不是直连了。真正意义上的 JS 直连运行环境必须是 Node.js 这类服务端 JS 运行时。这一点想清楚后面所有选型和参数才有意义。Node.js 连 MySQL 的驱动主流就两个老牌的mysql和现在事实上的标准mysql2。mysql包年久失修回调风格对 Promise 支持要靠promise-mysql这类包装mysql2是它的重写版原生支持 Promise、支持预处理语句prepared statement、性能更好还兼容大部分mysql的 API。新项目没有理由再用mysql直接上mysql2。安装很直接npm init -y npm install mysql2mysql2默认走的是回调风格但提供了mysql2/promise入口写起来清爽得多。下面这段是最小可运行版本先确认能连上再说别的// db.js —— 最小连接示例先验证连通性 const mysql require(mysql2/promise); async function main() { // 单连接仅用于验证生产环境请用连接池 const conn await mysql.createConnection({ host: 127.0.0.1, port: 3306, user: app_user, password: your_password, database: demo, charset: utf8mb4, }); const [rows] await conn.execute(SELECT 1 1 AS result); console.log(rows); // [ { result: 2 } ] await conn.end(); } main().catch(console.error);逻辑说明createConnection建立一条物理连接execute走的是预处理语句通道返回的[rows, fields]里rows是结果集。参数说明host建议写127.0.0.1而不是localhost因为某些环境下localhost会走 Unix socket 而不是 TCP排查问题时容易误导charset一定设成utf8mb4否则 emoji 和部分生僻字会变成问号这是血泪经验。2.2 连接池单连接为什么在生产环境必翻车单连接能跑通但一上并发就废。Node.js 是单线程事件循环一条连接同一时刻只能处理一个查询第二个请求进来只能排队QPS 稍微一高就雪崩。正确做法是用连接池让驱动帮你管理一组连接、按需分配。// pool.js —— 生产环境用的连接池 const mysql require(mysql2/promise); const pool mysql.createPool({ host: process.env.DB_HOST || 127.0.0.1, port: Number(process.env.DB_PORT) || 3306, user: process.env.DB_USER, password: process.env.DB_PASSWORD, database: process.env.DB_NAME, charset: utf8mb4, waitForConnections: true, // 连接耗尽时排队等待而不是直接报错 connectionLimit: 10, // 池内最大连接数 queueLimit: 0, // 0 表示排队数量不设上限 enableKeepAlive: true, // 保持长连接减少握手开销 keepAliveInitialDelay: 0, timezone: 08:00, // 时区避免时间字段偏移 }); module.exports pool;参数说明connectionLimit是最需要拿捏的一个。设太小高并发下请求排队设太大MySQL 侧连接数被打满反而拖垮数据库。经验值是「单实例 1020」再配合 MySQL 的max_connections留出余量。queueLimit: 0表示排队不设上限配合waitForConnections: true请求会等而不是立刻失败但要注意这会让超时表现为「请求卡住」得在业务层加超时控制。timezone不设的话DATETIME字段读出来可能差 8 小时这个坑非常隐蔽。用池的方式和单连接几乎一样只是从池里取const pool require(./pool); async function getUser(id) { const [rows] await pool.execute( SELECT id, name, created_at FROM users WHERE id ?, [id] ); return rows[0] || null; }注意这里用的是execute而不是query。execute走预处理语句参数通过占位符?传入驱动会做转义天然防 SQL 注入query是拼接字符串参数直接内插写不好就是注入漏洞。除非有特殊需求比如动态表名占位符不支持否则一律用execute。3. 从建表到查询把一条完整的数据链路跑通3.1 建一张带索引的表别让查询全表扫描驱动连上了接下来得有数据。建表时最容易忽略的是索引和字段类型。下面这张表覆盖了常见类型也顺手把索引建上CREATE TABLE orders ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT, user_id BIGINT UNSIGNED NOT NULL, amount DECIMAL(10, 2) NOT NULL DEFAULT 0.00, status TINYINT NOT NULL DEFAULT 0, remark VARCHAR(255) DEFAULT NULL, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_user_id (user_id), KEY idx_status_created (status, created_at) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;说明amount用DECIMAL而不是FLOAT金额计算不能有浮点误差status用TINYINT省空间idx_status_created是联合索引按「状态 时间」查列表时能直接命中。DEFAULT 0这种默认值设置在热词里被反复搜其实就一句话字段定义时写DEFAULT 0插入不传该列就自动填 0比在应用层兜底更省心。3.2 增删改查的 JS 写法与参数绑定有了表把 CRUD 写全。重点看参数怎么绑、返回值怎么取const pool require(./pool); // 插入拿到自增主键 async function createOrder(userId, amount) { const [result] await pool.execute( INSERT INTO orders (user_id, amount, status) VALUES (?, ?, ?), [userId, amount, 0] ); return result.insertId; // 自增 id } // 查询列表带分页和排序 async function listOrders(userId, page 1, size 20) { const offset (page - 1) * size; const [rows] await pool.execute( SELECT id, amount, status, created_at FROM orders WHERE user_id ? ORDER BY created_at DESC LIMIT ? OFFSET ?, [userId, size, offset] ); return rows; } // 更新注意 affectedRows async function markPaid(orderId) { const [result] await pool.execute( UPDATE orders SET status ? WHERE id ? AND status ?, [1, orderId, 0] ); return result.affectedRows; // 0 表示没更新到可能已支付 } // 删除 async function removeOrder(orderId) { const [result] await pool.execute(DELETE FROM orders WHERE id ?, [orderId]); return result.affectedRows; }逻辑说明execute返回的数组第一个元素插入时是OkPacket含insertId、affectedRows查询时是结果行数组。参数说明LIMIT ? OFFSET ?里的占位符mysql2会按数字处理但要注意某些旧版本驱动对LIMIT占位符支持有差异如果报语法错改成拼接整数先做parseInt校验即可。markPaid里加了AND status 0是乐观锁思路防止重复支付affectedRows为 0 就说明状态已经变了这个模式在订单场景非常实用。3.3 事务转账场景下不回滚就是事故涉及多表写入必须用事务。mysql2的连接池事务写法有个容易翻车的点必须从池里取同一条连接不能每条语句都从池里拿const pool require(./pool); async function transfer(fromId, toId, amount) { const conn await pool.getConnection(); // 关键取同一条连接 try { await conn.beginTransaction(); const [r1] await conn.execute( UPDATE accounts SET balance balance - ? WHERE id ? AND balance ?, [amount, fromId, amount] ); if (r1.affectedRows 0) throw new Error(余额不足); await conn.execute( UPDATE accounts SET balance balance ? WHERE id ?, [amount, toId] ); await conn.commit(); } catch (err) { await conn.rollback(); // 出错必须回滚 throw err; } finally { conn.release(); // 关键归还连接否则池会被耗尽 } }逻辑说明getConnection从池里借出一条连接beginTransaction到commit/rollback之间的所有语句都在这条连接上执行才属于同一个事务。参数说明finally里的release绝对不能漏漏一次就少一条可用连接跑一段时间池就空了表现为请求全部卡死——这是最经典的翻车现场。扣款那条 SQL 用balance ?做条件更新把「检查余额」和「扣款」合成原子操作避免并发下的超扣。4. 避坑与排查JS 连 MySQL 最常见的五类翻车4.1 连接报错 ECONNREFUSED 或 ETIMEDOUT现象启动就报connect ECONNREFUSED 127.0.0.1:3306或者卡很久后ETIMEDOUT。原因前者通常是 MySQL 没启动、端口不对或者bind-address只监听了127.0.0.1而你从别的机器连后者多是防火墙或安全组没放行 3306。解决先在服务器上mysql -u user -p本地登录确认服务活着再netstat -tlnp | grep 3306看监听地址跨机访问要确认bind-address 0.0.0.0且防火墙放行。4.2 SSL 连接错误现象报ER_SSL_CONNECTION_ERROR或握手失败。原因MySQL 8.0 默认可能要求或协商 SSL而客户端配置不匹配。解决内网可信环境可以显式关闭连接参数加ssl: false需要加密则配ssl: { rejectUnauthorized: true }并挂上 CA 证书。别在没搞清楚的情况下盲目rejectUnauthorized: false那等于放弃了证书校验。4.3 时间字段差 8 小时现象created_at读出来比实际早或晚 8 小时。原因MySQL 会话时区和 Node.js 进程时区不一致mysql2默认按本地时区解析DATETIME。解决连接参数里显式写timezone: 08:00或者统一用 UTC 存储、展示层再转换。这个坑不报错只是数据悄悄错最难查。4.4 连接池耗尽请求全部卡住现象服务跑一阵后所有请求无响应日志没有明显报错。原因某处getConnection后没release或者事务里抛异常没走到finally。解决所有借连接的地方都用try/finally包住release给池加监控定期打印pool.pool._allConnections.length观察连接数是否只增不减。4.5 中文乱码或 emoji 变问号现象写入的中文正常emoji 或生僻字变成?。原因库、表、连接三处字符集不一致某一处还是utf8MySQL 的utf8只支持 3 字节不是真正的 UTF-8。解决库表建的时候用utf8mb4连接参数写charset: utf8mb4三处对齐才行。5. 进阶技巧用预处理语句缓存和批量插入把性能再压一档5.1 预处理语句缓存别让驱动重复编译execute每次调用驱动默认会尝试复用已编译的预处理语句。但有个细节mysql2的语句缓存是按连接维度的连接池里每条连接各自缓存。如果你发现高频查询的prepare开销明显可以确认驱动版本是否支持namedPlaceholders和语句缓存并保持 SQL 文本完全一致多一个空格都会当成新语句。我一般会把高频 SQL 抽成常量避免在代码里手写导致文本漂移。5.2 批量插入一条 INSERT 顶一千条逐条INSERT在导入数据时慢得让人怀疑人生。正确姿势是拼多值插入async function batchInsert(rows) { // rows: [[userId, amount], [userId, amount], ...] if (rows.length 0) return 0; const placeholders rows.map(() (?, ?)).join(, ); const flat rows.flat(); const [result] await pool.execute( INSERT INTO orders (user_id, amount) VALUES ${placeholders}, flat ); return result.affectedRows; }逻辑说明把 N 行拼成一条VALUES (?,?),(?,?),...的 SQL一次网络往返搞定。参数说明flat把二维数组拍平成一维顺序要和占位符一一对应。注意单条 SQL 别太长超过max_allowed_packet会被截断报错一般几千行一批比较稳妥超大批量就分批循环。5.3 一个验证连接健康度的小习惯我习惯在服务启动时做一次自检从池里取连接、执行SELECT 1、再归还确认整条链路通。上线后如果出现「偶发查询超时」先看是不是池里存在被 MySQL 侧wait_timeout掐掉的死连接。mysql2的enableKeepAlive能缓解但更稳的做法是给池配idleTimeout让空闲连接主动回收。这些参数没有万能值得结合自己业务的并发曲线去调我踩过的坑基本都集中在「池参数拍脑袋设」和「忘了 release」这两件事上。把连接池当成有限资源去管理而不是当成随手可取的全局变量JS 直连 MySQL 这条路才算真正走稳。希望帮到你。本文还有配套的精品资源点击获取