常见错误

EMQ X 无法连接 MySQL 8.0

标签: MySQL 认证

TIP

4.3 已兼容 caching_sha2_password,该问题仅在 4.3 以下的版本中出现。

不同于以往版本,MySQL 8.0 对账号密码配置默认使用caching_sha2_password插件,需要将密码插件改成mysql_native_password

  • 修改 mysql.user

    1. ## 切换到 mysql 数据库
    2. mysql> use mysql;
    3. ## 查看 user 表
    4. mysql> select user, host, plugin from user;
    5. +------------------+-----------+-----------------------+
    6. | user | host | plugin |
    7. +------------------+-----------+-----------------------+
    8. | root | % | caching_sha2_password |
    9. | mysql.infoschema | localhost | caching_sha2_password |
    10. | mysql.session | localhost | caching_sha2_password |
    11. | mysql.sys | localhost | caching_sha2_password |
    12. | root | localhost | caching_sha2_password |
    13. +------------------+-----------+-----------------------+
    14. ## 修改密码插件
    15. mysql> ALTER USER 'your_username'@'your_host' IDENTIFIED WITH mysql_native_password BY 'your_password';
    16. Query OK, 0 rows affected (0.01 sec)
    17. ## 刷新
    18. mysql> FLUSH PRIVILEGES;
    19. Query OK, 0 rows affected (0.00 sec)
  • 修改 my.conf

    my.cnf 配置文件里面的 [mysqld] 下面加一行

    1. default_authentication_plugin=mysql_native_password
  • 重启 MySQL 即可

OPENSSL 版本不正确

标签: 启动失败

现象

执行 ./bin/emqx console 输出的错误内容包含:

  1. {application_start_failure,kernel,{{shutdown,{failed_to_start_child,kernel_safe_sup,{on_load_function_failed,crypto}}}, ..}

它表示,EMQ X 依赖的 Erlang/OTP 中的 crypto 应用启动失败。

解决方法

Linux

进入到 EMQ X 的安装目录(如果使用包管理工具安装 EMQ X,则应该进入与 EMQ X 的 lib 目录同级的位置)

  1. ## 安装包安装
  2. $ cd emqx
  3. ## 包管理器安装,例如 yum。则它的 lib 目录应该在 /lib/emqx
  4. $ cd /lib/emqx

查询 crypto依赖的 .so 动态库列表及其在内存中的地址:

  1. $ ldd lib/crypto-*/priv/lib/crypto.so
  2. lib/crypto-4.6/priv/lib/crypto.so: /lib64/libcrypto.so.10: version `OPENSSL_1.1.1' not found (required by lib/crypto-4.6/priv/lib/crypto.so)
  3. linux-vdso.so.1 => (0x00007fff67bfc000)
  4. libcrypto.so.10 => /lib64/libcrypto.so.10 (0x00007fee749ca000)
  5. libc.so.6 => /lib64/libc.so.6 (0x00007fee74609000)
  6. libdl.so.2 => /lib64/libdl.so.2 (0x00007fee74404000)
  7. libz.so.1 => /lib64/libz.so.1 (0x00007fee741ee000)
  8. /lib64/ld-linux-x86-64.so.2 (0x00007fee74fe5000)

其中 OPENSSL_1.1.1' not found表明指定的 OPENSSL 版本的 .so 库未正确安装。

源码编译安装 OPENSSL 1.1.1,并将其 so 文件放置到可以被系统识别的路径:

  1. ## 下在最新版本 1.1.1
  2. $ wget https://www.openssl.org/source/openssl-1.1.1c.tar.gz
  3. ## 上传至 ct-test-ha
  4. $ scp openssl-1.1.1c.tar.gz ct-test-ha:~/
  5. ## 解压并编译安装
  6. $ tar zxf openssl-1.1.1c.tar.gz
  7. $ cd openssl-1.1.1c
  8. $ ./config
  9. $ make test # 执行测试;如果输出 PASS 则继续
  10. $ make install
  11. ## 确保库的引用
  12. $ ln -s /usr/local/lib64/libssl.so.1.1 /usr/lib64/libssl.so.1.1
  13. $ ln -s /usr/local/lib64/libcrypto.so.1.1 /usr/lib64/libcrypto.so.1.1

完成后,执行在 EMQ X 的 lib 同级目录下执行 ldd lib/crypto-*/priv/lib/crypto.so ,检查是否已能正确识别。如果不在有 not found.so 库,即可正常启动 EMQ X。

macOS

进入到 EMQ X 的安装目录:

  1. ## 安装包安装
  2. $ cd emqx
  3. ## brew 安装
  4. $ cd /usr/local/Cellar/emqx/<version>/

查询 crypto依赖的 .so 动态库列表:

  1. $ otool -L lib/crypto-*/priv/lib/crypto.so
  2. lib/crypto-4.4.2.1/priv/lib/crypto.so:
  3. /usr/local/opt/openssl@1.1/lib/libcrypto.1.1.dylib (compatibility version 1.1.0, current version 1.1.0)
  4. /usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1252.200.5)

检查其显示 OPENSSL 已成功安装至指定的目录:

  1. $ ls /usr/local/opt/openssl@1.1/lib/libcrypto.1.1.dylib
  2. ls: /usr/local/opt/openssl@1.1/lib/libcrypto.1.1.dylib: No such file or directory

若不存在该文件,则需安装与 otool 打印出来的对应的 OPENSSL 版本,例如此处显示的为 openssl@1.1

  1. $ brew install openssl@1.1

安装完成后,即可正常启动 EMQ X。

Windows 缺失 MSVCR120.dll

标签: 启动失败

现象

Windows 执行 ./bin/emqx console 弹出错误窗口:

  1. 无法启动次程序,因为计算机中丢失 MSVCR120.dll。请尝试重新安装该程序以解决此问题。

error

解决方法

安装 Microsoft Visual C++ RedistributablePackage常见错误 - 图2 (opens new window)