开源 IoT平台ThingsBoard3.3.4源码编译问题记录

ThingsBoard 是一个基于Java的开源的物联网平台，用于数据收集、处理、可视化和设备管理。它使用物联网行业的标准协议（MQTT、CoAP和HTTP）实现设备连接，并支持云和本地部署。因为手头有项目用这个开源产品当作物联网数据采集传输代平台，用来代替以前公司自己开发的的数据采集传输软件（不稳定）。根据近两年来的项目实际使用经验，ThingsBoard是一款很优秀的产品，其高连接性，可靠性，稳定性，可伸缩性，可扩展性等指标都可以秒杀我们公司自研的基于c++的那套系统。

最近ThingsBoard相关项目部署在某央企云平台上，该云平台安全机制实时检查软件漏洞，发现漏洞限期整改，否则关停服务器。ThingsBoard源码中引用300多个第三方jar包，经常会有组件出现漏洞，靠等待官方升级根本来不及。只能自己靠自己源代码编译打包发布，编译源码一大堆的坑，把遇到的问题总结记录下来供大家参考。

1、Maven配置问题

因为ThingsBoard在编译过程中需要依赖很多国外的包，那么需要外网才能连接，建议连接到外网。如果公司设置内有代理服务器，别忘了setting.xml配置代理访问。

一般情况下，使用官方镜像更新依赖包，网速不稳定，可将Maven镜像源设置为淘宝的，在maven安装包目录下找到settings.xml设置，如下：

 <mirrors>
        <mirror>
            <id>alimaven</id>
            <name>aliyun maven</name>
            <mirrorOf>central</mirrorOf>
            <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
        </mirror>
    </mirrors>

建议同时把npm也设置为淘宝镜像。

同上，网速不好npm过程中也会下载失败，这是导致很多人编译失败的原因，所以我们在进行编译之前，也将npm替换为淘宝镜像：

npm install -g mirror-config-china --registry=http://registry.npm.taobao.org        #使用淘宝镜像
npm config get registry                                                             #查询当前镜像
npm config rm registry                                                              #删除自定义镜像，使用官方镜像
npm info express

编译时把系统代理服务器设置或IE代理服务器设置中的代理设置取消，经常导致 ThingsBoard Server UI模块编译失败。

2、缓存、或进程未关闭、或文件被占用导致编译出错

每次编译失败进行二次编译时，要清理缓存，并杀死遗留进程

执行下面命令，杀死遗留进程

taskkill /f /im java.exe

或者IDEA Maven工具进行清理。

在项目编译过程中要copy文件，如果node进程或其它进程没有关闭，也会报各种类型的错误信息。进入报错的模块，单独编译，添加参数 -X或-e 查询出错的具体信息，根据错误提示进行处理。

mvn clean install -DskipTests=true -X 或-e

最简单的方式就是重启电脑，建议重启。

3、软件版本问题，这是最常见的问题

Java版本，JDK版本必须11以上版本，我用的版本是11.0.18，最开始用的JDK11_4335520这个版本编译时发现各种错误。

再就是Node版本，我用的v16.15.1，NPM版本号，8.5.0

最后时yarn版本，v1.22.9。

node和yarn版本最好跟模块pom文件设置版本中保持一致。

<executions>
                    <execution>
                        <id>install node and yarn</id>
                        <goals>
                            <goal>install-node-and-yarn</goal>
                        </goals>
                        <configuration>
                            <nodeVersion>v16.15.1</nodeVersion>
                            <yarnVersion>v1.22.17</yarnVersion>
                        </configuration>
                    </execution>
                    <execution>
                        <id>yarn install</id>
                        <goals>
                            <goal>yarn</goal>
                        </goals>
                        <configuration>
                            <arguments>install</arguments>
                        </configuration>
                    </execution>
                    <execution>
                        <id>yarn pkg</id>
                        <goals>
                            <goal>yarn</goal>
                        </goals>
                        <phase>compile</phase>
                        <configuration>
                            <arguments>run pkg</arguments>
                        </configuration>
                    </execution>
                </executions>

注意：

编译项目跟网速和电脑配置有关，最好连接上外网进行编译，我这里完整编译大概需要20多分钟。

总结

在编译Thingsboard 3.3.4过程中遇到了各式各样的问题，编译过程很慢，50多个模块花费了几乎一整天的时间才编译成功，在此总结一下，也希望能帮助到更多朋友。