解決Node.js mysql客戶端不支持認證協議引起的「ER_NOT_SUPPORTED_AUTH_MODE」問題

mysql模塊（項目地址爲https://github.com/mysqljs/mysql）是一個開源的、JavaScript編寫的MySQL驅動，能夠在Node.js應用中來操做MySQL。但在使用過程當中，出現了「ER_NOT_SUPPORTED_AUTH_MODE」問題。

本文介紹了出現該問題的緣由及解決方案。

報錯信息

當我試圖使用mysql模塊來鏈接MySQL 8時，出現了以下錯誤信息：

D:\workspaceGithub\nodejs-book-samples\samples\mysql-demo\index.js:17
      throw error;
      ^

Error: ER_NOT_SUPPORTED_AUTH_MODE: Client does not support authentication protocol requested by server; consider upgrading MySQL client
    at Handshake.Sequence._packetToError (D:\workspaceGithub\nodejs-book-samples\samples\mysql-demo\node_modules\mysql\lib\protocol\sequences\Sequence.js:47:14)
    at Handshake.ErrorPacket (D:\workspaceGithub\nodejs-book-samples\samples\mysql-demo\node_modules\mysql\lib\protocol\sequences\Handshake.js:123:18)
    at Protocol._parsePacket (D:\workspaceGithub\nodejs-book-samples\samples\mysql-demo\node_modules\mysql\lib\protocol\Protocol.js:291:23)
    at Parser._parsePacket (D:\workspaceGithub\nodejs-book-samples\samples\mysql-demo\node_modules\mysql\lib\protocol\Parser.js:433:10)
    at Parser.write (D:\workspaceGithub\nodejs-book-samples\samples\mysql-demo\node_modules\mysql\lib\protocol\Parser.js:43:10)
    at Protocol.write (D:\workspaceGithub\nodejs-book-samples\samples\mysql-demo\node_modules\mysql\lib\protocol\Protocol.js:38:16)
    at Socket.<anonymous> (D:\workspaceGithub\nodejs-book-samples\samples\mysql-demo\node_modules\mysql\lib\Connection.js:91:28)
    at Socket.<anonymous> (D:\workspaceGithub\nodejs-book-samples\samples\mysql-demo\node_modules\mysql\lib\Connection.js:525:10)
    at Socket.emit (events.js:196:13)
    at addChunk (_stream_readable.js:290:12)
    --------------------
    at Protocol._enqueue (D:\workspaceGithub\nodejs-book-samples\samples\mysql-demo\node_modules\mysql\lib\protocol\Protocol.js:144:48)
    at Protocol.handshake (D:\workspaceGithub\nodejs-book-samples\samples\mysql-demo\node_modules\mysql\lib\protocol\Protocol.js:51:23)
    at Connection.connect (D:\workspaceGithub\nodejs-book-samples\samples\mysql-demo\node_modules\mysql\lib\Connection.js:119:18)
    at Object.<anonymous> (D:\workspaceGithub\nodejs-book-samples\samples\mysql-demo\index.js:12:12)
    at Module._compile (internal/modules/cjs/loader.js:759:30)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:770:10)
    at Module.load (internal/modules/cjs/loader.js:628:32)
    at Function.Module._load (internal/modules/cjs/loader.js:555:12)
    at Function.Module.runMain (internal/modules/cjs/loader.js:826:10)
    at internal/main/run_main_module.js:17:11

出錯緣由

致使這個錯誤的緣由是，目前，最新的mysql模塊並未徹底支持MySQL 8的「caching_sha2_password」加密方式，而「caching_sha2_password」在MySQL 8中是默認的加密方式。所以，下面的方式命令是默認已經使用了「caching_sha2_password」加密方式，該帳號、密碼沒法在mysql模塊中使用。

mysql> ALTER USER 'root'@'localhost' IDENTIFIED BY '123456';
Query OK, 0 rows affected (0.12 sec)

解決方法

解決方法是重新修改用戶root的密碼，並指定mysql模塊可以支持的加密方式：

mysql> ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '123456';
Query OK, 0 rows affected (0.12 sec)

上述語句，顯示指定了使用「mysql_native_password」的加密方式。這種方式是在mysql模塊可以支持。

再此運行應用，能夠看到以下的控制檯輸出信息：

$ node index.js

The result is:  RowDataPacket { user_id: 1, username: '老衛' }

其中，「RowDataPacket { user_id: 1, username: '老衛' }」就是數據庫查詢的結果。

源碼

本節例子能夠在https://github.com/waylau/nodejs-book-samples的「mysql-demo」應用中找到。

參考引用

• 本文同步至: https://waylau.com/node.js-mysql-client-does-not-support-authentication-protocol/
• 有關MySQL 8的「caching_sha2_password」加密方式，可見https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-caching-sha2-password