一、EMQX 无法连接 MySQL 8.0
提示：4.3 已兼容 caching_sha2_password，该问题仅在 4.3 以下的版本中出现。
不同于以往版本，MySQL 8.0 对账号密码配置默认使用caching_sha2_password插件，需要将密码插件改成mysql_native_password
修改
mysql.user表## 切换到 mysql 数据库 mysql> use mysql; ## 查看 user 表 mysql> select user, host, plugin from user; +------------------+-----------+-----------------------+ | user | host | plugin | +------------------+-----------+-----------------------+ | root | % | caching_sha2_password | | mysql.infoschema | localhost | caching_sha2_password | | mysql.session | localhost | caching_sha2_password | | mysql.sys | localhost | caching_sha2_password | | root | localhost | caching_sha2_password | +------------------+-----------+-----------------------+ ## 修改密码插件 mysql> ALTER USER 'your_username'@'your_host' IDENTIFIED WITH mysql_native_password BY 'your_password';Query OK, 0 rows affected (0.01 sec) ## 刷新 mysql> FLUSH PRIVILEGES; Query OK, 0 rows affected (0.00 sec)
修改my.conf
在
my.cnf配置文件里面的 [mysqld] 下面加一行default_authentication_plugin=mysql_native_password
重启MYSQL即可
二、OPENSSL 版本不正确
现象
执行./bin/emqx console 输出的错误内容包含：
{application_start_failure,kernel,{{shutdown,{failed_to_start_child,kernel_safe_sup,{on_load_function_failed,crypto}}}, ..}解决方法
Linux
进入到 EMQX 的安装目录（如果使用包管理工具安装 EMQX，则应该进入与 EMQX 的 lib 目录同级的位置）
## 安装包安装 $ cd emqx ## 包管理器安装，例如 yum。则它的 lib 目录应该在 /lib/emqx $ cd /lib/emqx
查询 crypto依赖的 .so 动态库列表及其在内存中的地址：
$ ldd lib/crypto-*/priv/lib/crypto.so 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) linux-vdso.so.1 => (0x00007fff67bfc000) libcrypto.so.10 => /lib64/libcrypto.so.10 (0x00007fee749ca000) libc.so.6 => /lib64/libc.so.6 (0x00007fee74609000) libdl.so.2 => /lib64/libdl.so.2 (0x00007fee74404000) libz.so.1 => /lib64/libz.so.1 (0x00007fee741ee000) /lib64/ld-linux-x86-64.so.2 (0x00007fee74fe5000)
其中 OPENSSL_1.1.1' not found表明指定的 OPENSSL 版本的 .so 库未正确安装。
源码编译安装 OPENSSL 1.1.1，并将其 so 文件放置到可以被系统识别的路径：
## 下在最新版本 1.1.1 $ wget https://www.openssl.org/source/openssl-1.1.1n.tar.gz ## 解压并编译安装 $ tar zxf openssl-1.1.1n.tar.gz $ cd openssl-1.1.1n $ ./config $ make test # 执行测试；如果输出 PASS 则继续 $ make install ## 确保库的引用 $ ln -s /usr/local/lib64/libssl.so.1.1 /usr/lib64/libssl.so.1.1 $ ln -s /usr/local/lib64/libcrypto.so.1.1 /usr/lib64/libcrypto.so.1.1
完成后，执行在 EMQX 的 lib 同级目录下执行 ldd lib/crypto-*/priv/lib/crypto.so ，检查是否已能正确识别。如果不在有 not found 的 .so 库，即可正常启动 EMQX。
macOS
进入到EMQX的安装目录：
## 安装包安装 $ cd emqx ## brew 安装 $ cd /usr/local/Cellar/emqx/<version>/
查询 crypto依赖的 .so 动态库列表：
$ otool -L lib/crypto-*/priv/lib/crypto.so lib/crypto-4.4.2.1/priv/lib/crypto.so: /usr/local/opt/openssl@1.1/lib/libcrypto.1.1.dylib (compatibility version 1.1.0, current version 1.1.0) /usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1252.200.5)
检查其显示 OPENSSL 已成功安装至指定的目录：
$ ls /usr/local/opt/openssl@1.1/lib/libcrypto.1.1.dylib ls: /usr/local/opt/openssl@1.1/lib/libcrypto.1.1.dylib: No such file or directory
若不存在该文件，则需安装与 otool 打印出来的对应的 OPENSSL 版本，例如此处显示的为 openssl@1.1：
$ brew install openssl@1.1
安装完成后，即可正常启动 EMQX。
三、Windows 缺失 MSVCR120.dll
现象
Windows 执行 ./bin/emqx console 弹出错误窗口：
无法启动次程序，因为计算机中丢失 MSVCR120.dll。请尝试重新安装该程序以解决此问题。
解决方法
安装 Microsoft Visual C++ RedistributablePackage
四、SSL连接失败
现象
客户端无法与 EMQX 建立 SSL 连接。
解决方法
可以借助 EMQX 日志中的关键字来进行简单的问题排查，EMQX 日志相关内容请参考：日志与追踪。
certificate_expired
日志中出现
certificate_expired关键字，说明证书已经过期，请及时续签。no_suitable_cipher
日志中出现
no_suitable_cipher关键字，说明握手过程中没有找到合适的密码套件，可能原因有证书类型与密码套件不匹配、没有找到服务端和客户端同时支持的密码套件等等。handshake_failure
日志中出现
handshake_failure关键字，原因有很多，可能要结合客户端的报错来分析，例如，可能是客户端发现连接的服务器地址与服务器证书中的域名不匹配。unknown_ca
日志中出现
unknown_ca关键字，意味着证书校验失败，常见原因有遗漏了中间 CA 证书、未指定 Root CA 证书或者指定了错误的 Root CA 证书。在双向认证中我们可以根据日志中的其他信息来判断是服务端还是客户端的证书配置出错。如果是服务端证书存在问题，那么报错日志通常为：{ssl_error,{tls_alert,{unknown_ca,"TLS server: In state certify received CLIENT ALERT: Fatal - Unknown CA\n"}}}看到
CLIENT ALERT就可以得知，这是来自客户端的警告信息，服务端证书未能通过客户端的检查。如果是客户端证书存在问题，那么报错日志通常为：
{ssl_error,{tls_alert,{unknown_ca,"TLS server: In state certify at ssl_handshake.erl:1887 generated SERVER ALERT: Fatal - Unknown CA\n"}}}看到
SERVER ALERT就能够得知，表示服务端在检查客户端证书时发现该证书无法通过认证，而客户端将收到来自服务端的警告信息。protocol_version
日志中出现
protocol_version关键字，说明客户端与服务器支持的 TLS 协议版本不匹配。