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行，果然是这个绝对地址：

<!-- Set parameters for manpage xsl -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
	<xsl:import href="/usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/docbook.xsl"/>
	<!-- Don't display notes list of link urls. -->
	<xsl:param name="man.endnotes.list.enabled">0</xsl:param>
	<xsl:param name="man.endnotes.are.numbered">0</xsl:param>
	<!-- But if we do, set a base url for the relative links. -->
	<xsl:param name="man.base.url.for.relative.links">http://mosquitto.org/man/</xsl:param>
	<!-- Don't output filename when generating. -->
	<xsl:param name="man.output.quietly" select="1"></xsl:param>
	<!-- Generate ansi style function synopses. -->
	<xsl:param name="man.funcsynopsis.style">ansi</xsl:param>
</xsl:stylesheet>

通过命令查找文件 docbook.xsl，在本机中也没有发现，因此基本可以确定是找不到这个文件所致：

[root@localhost mosquitto-1.2]# find / -name docbook.xsl

解决办法：

1.安装docbook-style-xsl

使用命令：yum -y install docbook-style-xsl

【也可下载到本地后安装：

（1）下载地址：我的CSDN资源列表

执行命令：sudo rpm -ivh docbook-style-xsl-1.75.2-6.el6.noarch.rpm   --force --nodeps

替换成下载的版本即可

】

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 <SRC> # i.e. your source code homewget http://c-ares.haxx.se/download/c-ares-1.10.0.tar.gztar xvf c-ares-1.10.0.tar.gzcd c-ares-1.10.0./configuremakesudo make install

问题七：无法接受到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的消息。

问题七：    
    ../../config.h:86:27: fatal error: cjson/cJSON.h: 没有那个文件或目录
 #  include <cjson/cJSON.h>
                           ^
compilation terminated.
解决办法：下载cjson并安装，步骤如下（以cJSON-1.7.11为例）
1、下载cJSON-1.7.11.tar；
2、进入到目录，依次执行：make  和 make install 两条命令。