mosquitto 使用时出现的一些问题及其解决办法
问题一：问题描述：
在centos7上编译mosquitto源码时，出现以下问题：
make[1]: 进入目录“/home/jason/mosquitto-1.2/man”
xsltproc mosquitto.8.xml
warning: failed to load external entity "/usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/docbook.xsl"
compilation error: file manpage.xsl line 3 element import
xsl:import : unable to load /usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/docbook.xsl
compilation error: file mosquitto.8.xml line 4 element refentry
xsltParseStylesheetProcess : document is not a stylesheet
make[1]: *** [mosquitto.8] 错误 5
make[1]: 离开目录“/home/jason/mosquitto-1.2/man”
make: *** [docs] 错误 2
由提示可以看到，此时问题的原因在于在文件：manpage.xsl里面加载不了：docbook.xsl所致，错误提示中也显示在绝对路径：
/usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/docbook.xsl
下找不到这个文件：
docbook.xsl
再看文件manpage.xsl里，按照所提示第3行，果然是这个绝对地址：
0
0
http://mosquitto.org/man/
ansi
通过命令查找文件 docbook.xsl，在本机中也没有发现，因此基本可以确定是找不到这个文件所致：
[root@localhost mosquitto-1.2]# find / -name docbook.xsl
解决办法：
1.安装docbook-style-xsl
使用命令：yum -y install docbook-style-xsl
2.查看文件docbook.xsl被安装到了哪里：
例如：
[root@localhost tools]# find / -name docbook.xsl
/usr/share/sgml/docbook/xsl-stylesheets-1.78.1/epub/docbook.xsl
/usr/share/sgml/docbook/xsl-stylesheets-1.78.1/fo/docbook.xsl
/usr/share/sgml/docbook/xsl-stylesheets-1.78.1/html/docbook.xsl
/usr/share/sgml/docbook/xsl-stylesheets-1.78.1/manpages/docbook.xsl
/usr/share/sgml/docbook/xsl-stylesheets-1.78.1/xhtml/docbook.xsl
/usr/share/sgml/docbook/xsl-stylesheets-1.78.1/xhtml-1_1/docbook.xsl
3.搜索到之后，将上面红字中的地址修改到文件manpage.xsl里的对应位置；
4.再重新编译mosquitto，问题已经解决！
问题二：执行mosquitto客户端程序时出现找不到动态库：libmosquitto.so.1
./mosquitto_sub: error while loading shared libraries: libmosquitto.so.1: cannot open shared object file: No such file or directory
解决办法：
编译完mosquitto之后，进入到lib目录下，将编译之后的libmosquitto.so.1 拷贝到目录/usr/local/lib下，执行如下命令：
cp libmosquitto.so.1 /usr/local/lib
然后再执行：
执行命令：
sudo ln -s /usr/local/lib/libmosquitto.so.1 /usr/lib/libmosquitto.so.1
和
ldconfig
即可
问题三： Invalid user 'mosquitto'.
[root@localhost src]# ./mosquitto
1437558553: Error: Invalid user 'mosquitto'.两种解决办法：
（1）修改配置文件:mosquitto.conf ，增加登录的用户，例如当前登录用户为root
（1）执行命令增加当前用户：
adduser mosquitto
如下图：
问题四：
在修改mosquitto源码之后，换到centos环境下重新编译时可能会出现下面的问题：
mosquitto.c:271:2: 错误：缺少结尾的 " 字符
snprintf(buf, 1024, "%s", CHANGESET);
^
mosquitto.c:271:37: 错误：expected expression before ‘)’ token
snprintf(buf, 1024, "%s", CHANGESET);
^
该问题的原因是文件：changeset的格式不对，可在centos环境下，按照如下方式修改此文件的格式：
使用vi打开此文件，然后使用：
:set ff=unix
重新设置一下此文件的格式，然后保存退出即可
问题五：xsltproc: Command not found
mosquitto编译的时候出现问题：xsltproc: Command not found
如下图所示：
解决办法：安装libxslt
yum -y install libxslt
问题六：
./mosquitto_internal.h:40:20: error: ares.h: No such file or directory
解决办法：
- 方法1关掉：则要到configure.mk文件中，把配置项WITH_SRV关掉，再编译就行了如下：
WITH_SRV=no
- 方法2启用：
cd
问题七：无法接受到mosquitto的系统topic的消息
mosquitto的系统topic主要是以$SYS开头的topic，这些topic只能mosquitto自己发送，客户端只能订阅，无法发送；mosquitto的系统topic主要用于mosquitto对外发布一些自身状态的消息，例如当前客户端连接数量等等，如下所示：
当前mosquitto维持的客户端数量：$SYS/broker/clients/total
当前mosquitto维护的活跃的客户端数量：$SYS/broker/clients/inactive
等等；
这些系统topic对于我们探查正在运行中的mosquitto的内部状态非常有用，但是mosquitto默认不开启这些topic；如果要开启这些系统topic的消息发布功能，需要如下两步操作：
（1）修改mosquitto的编译配置文件：config.mk，打开如下配置项（去掉该配置项前面的注释符号#）：
WITH_SYS_TREE:=yes
然后重新编译mosquitto即可。
（2）修改mosquitto的配置文件mosquitto.conf里的配置项：sys_interval，该项表示系统消息的发布时间间隔（单位：秒），需将该值设置为大于0，否则视为禁用；【在启动mosquito的时候需要显示制定这里修改过的配置文件：mosquitto.conf，例如使用启动命令：./mosquitto -c mosquitto.conf，否则如果不指定任何配置文件，例如使用启动命令：./mosquitto，就会使用默认配置项，即：禁用该功能】
sys_interval 180
注意：并不是所有系统topic的消息都是定时发布，某些topic如果消息没有变化，是不会更新的，例如：
$SYS/broker/clients/total
$SYS/broker/clients/maximum
$SYS/broker/clients/inactive
$SYS/broker/clients/active
$SYS/broker/clients/expired
还有一些系统topic是定时更新，例如：
$SYS/broker/load/messages/received/1min
$SYS/broker/load/messages/sent/1min
$SYS/broker/load/publish/dropped/1min
$SYS/broker/load/publish/received/1min
等等。
但是上述系统topic的消息都开启了retain功能，mosquitto发布的这些消息中，最近的一条消息都会被保存起来，客户端一上线就会立即受到上次mosquittopub的消息。