常见问题
提示
遇到未解决的问题或者Bug,请提交 Issue
1. 后端报错提示找不到数据库表
Mysql版本不能低于5.7,建议使用5.7版本。Linux中安装数据库,配置大小写敏感,在 /etc/my.cnf 添加 lower_case_table_names=1 重启MYSQL服务。
2. 后端报错提示找不到包
项目JDK使用1.8版本,如果安装了其他高版本,简单处理就直接卸载其他版本,或者自己安装缺少的依赖。
3. 后端运行报错的其他问题
项目依赖Redis和Emqx,确保正确配置Redis连接地址和密码;Emqx正确配置了Http认证地址和Webhook地址,后端正确配置了Emqx的连接地址。
4. 前端安装包的时候报错 npm ERR! code ERESOLVE
npm7.X版本的检查比之前版本严格,可以使用 npm i --legacy-peer-deps 或 npx -p npm@6 npm i --legacy-peer-deps 命令安装。或者安装npm6.X版本。
5. 前端install时候报错 syscall mkdirnpm ERR
删除C:\Users{账户}\下的.npmrc文件即可。
6. 前端项目打包时提示 Entrypoint size limit 的警告
问题:vue-cli打包项目时警告: entrypoint size limit: The following entrypoint(s) combined asset size exceeds the recommended limit (244 KiB). This can impact web performance.
解决:直接在vue.config.js文件中配置:
7.前端部署后报错Error. Cannot find module'@/views/XXX'
问题:在本地运行没有问题,部署后报错Error. Cannot find module'@/views/XXX'
解决:1、找到文件路径: srclstorelmoduleslpermission.js
2、修改此段代码
// 修改前
export const loadview = (view) => {
if (process.env.NODE ENV ==='development') {
return (resolve) => require([`@/views/${view}`], resolve)
} else {
// 使用 import 实现生产环境的路由加载
return () => import(`@/views/${view}`)
}
}
// 修改后
export constloadView = (view) => {
return (resolve) => require([`@/views/${view}`], resolve)
}8. 获取到实时监测数据,设备首页和运行状态不显示监测到的数据
实时监测数据是用来实时查看的,不会存储到数据库,所以对应的监测值没有改变。可以通过设备端定时上报属性(监测数据是属性的一种),存储到数据库;或者系统中设置定时上报属性功能。
9.固定大屏添加方式
- 开源版本切换到商业版本,前端需要重新安装一下包,执行
npm install - 后台添加大屏展示菜单:系统管理 -> 菜单管理 -> 新增
上级菜单:主类目
菜单类型:目录
菜单图标:monitor-a
菜单名称:大屏展示
是否外链:是
显示排序:5
路由地址:https://iot.fastbee.cn/bigScreen https://iot.fastbee.cn改为自己服务器的地址
显示状态:显示
菜单状态:正常10.设备激活/设备状态
设备有 未激活 在线离线 禁用 几种状态,有三种方式可以更改设备状态:
- 设备认证,认证成功后状态变更为在线
- 发布设备信息主题,主题消息内容中状态固定为3=在线
# 描述:1.设备上电后发布设备信息; 2.设备接收到设备信息指令后发布设备信息
# rssi 设备信号(信号极好[-55— 0],信号好[-70— -55],信号一般[-85— -70],信号差[-100— -85])
# status 设备状态,固定为3,表示在线
# firmwareVersion 固件版本
# userId 可选,用户的ID,可设置为admin用户ID为1,仅Wifi类设备需要上传用户ID,配网时再分配设备给用户。
# longitude 可选,经度,使用设备定位时需要上传
# latitude 可选,纬度,使用设备定位时需要上传
# summary 可选,摘要,设备的配置信息等,json格式,对象可自定义
{
"rssi": -43,
"firmwareVersion": 1.2,
"status": 3,
"userId": "1",
"longitude": 0,
"latitude": 0,
"summary": {}
}- 设备断电或者离线后,状态更新为离线。
设备离线需要超过设备端配置的保活/心跳时间的1.5倍
- 例如:设备端配置了10S的
keep-alive值,则设备的离线时间是10 X 1.5 = 15s - 注意:设备端配置的保活时间要小于系统配置的保活时间,系统默认配置70s,则设备端配置的保活时间不能大于60S
11.设备配网 / 扫码添加设备
提示
有两种情况:第一种是系统不存在该设备,配网或扫码后会新建设备到用户账号下;第二种是系统已存在该设备,配网或扫码后是关联设备到用户账号下。
设备配网:通过配网可以把wifi信息配置到设备,以及新建设备到用户账号下。目前H5、微信小程序、安卓和IOS都支持单设备配网,多设备配网只有微信小程序支持。单设备配网时用户手动切换手机wifi为设备热点,然后进行配网。
扫码添加设备:用户通过扫码新建设备到自己账号下。系统中的每个设备都有二维码,在设备详情摘要中查看。二维码固定为下面JSON格式:
# type固定值为1,代表扫码添加设备
# type、deviceNumber、productId 为必填项,productName为可选项
{
"type": 1,
"deviceNumber": "D888666",
"productId": 5,
"productName": "智能插座"
}12.多租户说明
系统默认包含五种类型账号:超级管理员,管理员、游客、租户、用户,通过角色区分。默认注册的账号为普通用户,可以重新给用户分配角色。
- 超级管理员:admin账号,且只有一个。可以管理系统所有数据。
- 管理员:可以管理系统所有数据,具体权限可自定义。
- 游客:用于项目的演示,相对于管理员,缺少数据删除的权限和部分功能权限。
- 租户:可以查询系统定义的产品分类和通用物模型,以及管理自己的产品、产品分类、通用物模型、产品固件、设备分组、场景联动和产品下的所有设备。
- 用户:管理自己的分组、设备和场景联动,以及其他用户分享给自己的设备。
13.系统账号
# 后台添加用户:默认密码为123456
管理员 admin admin123
游客账号 fastbee 123456
租户T1 fastbee-t1 123456
用户U1 fastbee-u1 12345614.数据监控账号
# 文件位于 fastbee\springboot\fastbee-admin\src\main\resources\application-druid.yml
# 数据监控的账号密码配置,默认fastbee
statViewServlet:
enabled: true
# 设置白名单,不填则允许所有访问
allow:
url-pattern: /druid/*
# 控制台管理用户名和密码
login-username: fastbee
login-password: fastbee15.服务器配置推荐
推荐4核8G,100G硬盘以上服务器配置,这个配置一般阿里云、腾讯云等云服务器都有对应优惠活动。
16.名词解释
物模型:物模型是产品或设备的数据模型。包括属性、功能和事件。属性指设备的状态、配置和监测数据,例如温湿度;监测数据只能读取,配置和状态可以读取和写入。功能用于执行某项特定任务,例如打开风扇,可读取和写入。事件是设备主动上报给系统,例如温度过高,设备异常等。
设备影子:用于缓存设备的属性和功能。设备离线时可以控制设备,设备上线后系统把离线控制的属性和功能下发给设备,设备作出响应。
场景联动:一种自动化业务逻辑的可视化编程方式。例如设置晚上回家这个场景,门锁一打开,就把电视、饮水机和空调打开。
17.Maven插件配置
# 文件位于 fastbee\springboot\pom.xml
# 配置bootclasspath项,windows使用`;` ,linux使用 `:`
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.1</version>
<configuration>
<source>${java.version}</source>
<target>${java.version}</target>
<encoding>${project.build.sourceEncoding}</encoding>
<compilerArguments>
<!-- rt.jar和jce.jar中间的分隔符,windows为“;”,linux为“:” -->
<bootclasspath>${java.home}/lib/rt.jar;${java.home}/lib/jce.jar</bootclasspath>
</compilerArguments>
</configuration>
</plugin>
</plugins>18.日志文件配置
# 文件位于 fastbee\springboot\fastbee-admin\src\main\resources\lockback.xml
<!-- 日志存放路径 -->
<property name="log.path" value="/logs" />
<!-- 日志输出格式 -->
<property name="log.pattern" value="%d{HH:mm:ss.SSS} [%thread] %-5level %logger{20} - [%method,%line] - %msg%n" />19.文件上传路径配置
# 文件位于 fastbee\springboot\fastbee-admin\src\main\resources\application.yml
# 文件路径,以uploadPath结尾 示例( Windows配置D:/uploadPath,Linux配置 /var/data/javva/uploadPath)
profile: /uploadPath20.实时监测没有数据
实时监测消息是用户端和设备直接交互,不会存储数据。
- 用户端发送实时监测信号,包含次数和间隔。设备订阅该实时监测信号。
- 设备根据订阅到的实时监测信号次数和间隔,发布实时监测数据。用户端订阅该监测数据,并实时显示。
21.mqtt客户端认证
服务端、web端、手机端和设备端都是一个mqtt客户端,需要一个账号密码来连接EMQX。系统使用EMQX的HTTP认证插件,约定clientId的起始部分为他的来源,如服务端的clientId以 server- 开头,前端以 web- 开头,移动端的以 phone- 开头,设备端根据加密方式以 S 或 E 开头。
- 服务端根据后端配置的Mqtt账号密码认证
- web端和phone端使用token认证
- 设备端根据产品信息里面的Mqtt账号、密码、密钥和加密方式认证
22.EMQX钩子实现设备上线和下线
- 在物联网中由于硬件或网络原因,设备可能频繁上下线。当设备离线时,用户发送指令,设备是接收不到的,如果启用影子模式该指令会存储到redis中,等到设备上线时执行,下发给设备。
- 使用Emqx作为消息服务器,系统中设备上下线的监控是由EMQX webhook来实现的,当检测到设备上下线时就会调用
http://localhost:8080/iot/tool/mqtt/webhookv5接口,更新设备上下线状态,上线时如果设备启用影子模式,就把离线后的操作下发给设备。
23. 影子模式和在线模式区别
- 在线模式: 用户端发布属性和功能消息,设备端订阅到消息并作出响应。最后设备发布属性和功能消息,服务端订阅后存储。
- 影子模式: 用户端发布属性和功能消息,后端订阅并存储。设备上线后,后端发布变更的属性和功能消息,设备端订阅并作出响应。
24. 可视化运行失败
可视化平台使用活可视化运行失败参考文档
https://fastbee.cn/doc/manual/visual.html#_4-%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9
25. 视频设备状态不更新,显示未激活,通道ID显示未使用
- java的sip服务是否开启,是否成功运行,服务器安全组是否添加,windows运行防火墙需要关闭
- 查看udp端口是否监听,window命令: netstat -p udp -ano | find "5061" linux命令: netstat -nlup | grep 5061
- 设备信息是否填写正确,服务器域,服务器ID,认证密码是否和产品配置保持一致
- java是否有sip相关注册日志,抓包查看udp端口5061 是否有包上来
26. 视频卡顿/视频加载慢
视频码率太大,设备与平台之间的带宽太小,视频传输不上来或丢包。 解决:去设备配置界面里把视频码率降低下来,通常在设备的音视频配置菜单内; 如果设备支持主辅码流选择,选择发送辅码流会顺畅很多; 如果是通过有线或WIFI发送视频,建议视频码率调整到1500kps以下,如果是通过4G卡传输,则调整到800kbps以下; 检查你的电脑的网络情况,是否有足够带宽播放视频;
27. 视频通道问题
备注册进来,但是设备下没有通道,这种情况通常发生在硬盘录像机接入的情况。 解决方法:打开监控设备的平台接入配置界面,通常在界面下方会有视频通道列表,把视频通道编号添加进去,通道编号自己编写即可,要求是20位数字并且符合国标编码规范,编号不能重复。 可以按顺序填入如下编号:34020000001320000001,34020000001320000002
28. 设备上线方式/设备激活/激活/未激活
设备认证,认证成功后状态变更为在线自动激活
29. java版本/jdk版本
项目目前支持jdk1.8,以及jdk11版本
30. 系统运行服务器/服务器配置要求/运行要求/最低配置/运行配置
推荐4核8G,100G硬盘以上服务器配置,这个配置一般阿里云、腾讯云等云服务器都有对应优惠活动。
31. 数据监控账号
- 默认账号密码 fastbee fastbee
- 可以通过后端yml文件重新配置对应账号
32. 技术栈/后端技术/前端技术/移动端技术/你们商业版用的什么技术?
- 后端技术:包括Spring Boot, MyBatis, Spring Security, Jwt, Redis, TDengine等,确保了后端服务的稳定性和高效性。
- 前端技术:使用ES6, ES7, Vue, Vuex, uView, H5等现代前端技术,提升了用户界面的交互性和视觉体验。
- 移动端支持:支持微信小程序、安卓和苹果等多种移动平台,通过Uniapp实现跨平台应用开发,方便用户在不同设备上进行操作和管理。
33. 人工客服/商业咨询/联系方式/授权咨询/电话/联系电话
扫描下面二维码联系客服

34. 私有仓库不见了/私有仓库地址/私有仓库代码拉取不了/拉不了代码
- 私有仓库地址:https://code.fastbee.cn/;
- 登录私有仓库进去看一下,是否有项目,也可以请添加客服微信,让客服那边帮忙查询一下是否到期了。
- 订阅更新到期之后,就不能再获取源码更新,可以联系客服订阅更新或获取到期时间最新源码。
35. 这种项目可以做吗?
可以添加下客服微信,具体是否能做需要我们技术人员做一个评估。
36. 公司信息/公司介绍/公司具体地址
- 公司名称:曲靖蜂信科技有限公司
- 公司地址:云南省曲靖市麒麟区太和街道太和社区三组17栋133号
- 联系邮箱:164770707@qq.com
- 公司介绍:公司主要从事物联网系统的开发和销售,主要产品为FastBee物联网平台,包含开源版本、商业版本和集群版本。其他产品包括FastBee组态、FastBee视频监控、FastBee智能音响等等。
- 参考文档:https://fastbee.cn/doc/sponsor/
- 客服微信:

37. 投诉/投诉举报
- 联系QQ:164770707
- 联系邮箱:164770707@qq.com
- 联系微信:

38. 可以帮忙部署吗/系统如何部署/系统部署
服务器安装好docker和docker-compose可以使用一键部署命令,或者联系客服付费让技术帮忙部署一份。
参考文档 http://localhost:8080/doc/install/docker.html
39. 合同/开票
购买后提供合同发票和授权证书,目前是小规模纳税人,发票为普票,税率1%,如果需要开专票税率3%,联系客服咨询下。
40. 购买后提供几个私有仓库账号/一个公司几个账户
为了方便管理,购买后每家公司提供一个私有仓库账号,公司统一用这个账号获取代码就可以了。
41. 案例/场景/案例展示/应用案例/设备接入案例/有没有案例/智慧农业是你们的吗/智慧农业怎么卖
我们开发的是通用物联网平台,场景案例都是用户自己开发的。
- 智慧农业案例:需要可以联系客服推荐拉群沟通,案例介绍:http://localhost:8080/doc/case/frog.html
- 华普设备接入案例:华普物联-T200 http://localhost:8080/doc/start/huapu.html
- 智嵌物联设备接入案例:智嵌物联-GE300D http://localhost:8080/doc/start/zhiqian.html
- mqttx模拟设备接入:http://localhost:8080/doc/start/mqtt.html
42. 每个版本更新的功能有哪些/每个版本有什么不一样/更新的功能有哪些?
可以参考下我们官方文档 http://localhost:8080/doc/
43. 组态/组态怎么用/Web组态大致有什么用途?目前功能完善程度如何/数据可视化和组态的区别
- 可以看一下我们的组态管理文档:https://fastbee.cn/doc/pages/scada/
- 组态编辑器:https://fastbee.cn/doc/pages/scadaEditer/
- 组态目前都已经是支持了可以导入3D了,只是3D只能是URl的形式,目前我们还没开发3D编辑器。
- web组态根据需求,是单独付费模块。
- 数据可视化和大屏的区别:可视化大屏数据交互是通过接口查询的,web组态可直接绑定物模型,用mqtt进行数据交互,可在页面上直接下发指令。
44. 视频协议/视频中心支持什么协议/可以接什么监控设备/萤石云,海康sdk接入、AI SDK接入,萤石云接入多少钱
支持gb28181协议的摄像头,海康,推流拉流和存储。萤石云,海康sdk接入、AI SDK接入,萤石云接入暂时还不支持,可以联系客服咨询定制
45.有演示站点吗/演示站点/演示地址/演示账号
- 演示站点地址 iot.fastbee.cn
- 账号密码: fastbee 123456
46. 采购流程是怎么样的/怎么采购/采购
- 采购商授权信息登记表(这个表麻烦填一下发给我,不用盖章, 你们公司能接一些定制项目的话就写上, 后面我们遇到其他客户有需要定制项目的就推荐给你们,可以合作一下);
- 合同(内容一般不支持修改,麻烦填写贵司名称和基本信息后签字盖章,需要电子版合同麻烦扫描给我,若需要纸质版合同麻烦按此地址邮寄: 云南省曲靖市麒麟区太和街道太和社区三组静和巷17幢133号 毕小佳 18687901546,到付拒收);
- 付款(签合同约定工作日内付款,过期未付视为合同无效);
- 开票(付款后1个工作日内开发票,我司属于小规模纳税人,税务局要求我们开的是普票,税率是1%。);
- 交付源码(付款后1个工作日内交付源码,私有仓库地址:https://code.fastbee.cn/ ,提供一个账户,一年内可以获取源码更新)
- 授权证书(授权为永久授权)。
- 加入企业群聊(加入后麻烦按群公告改备注,没改昵称的群员管理员会定期清理)
47. 怎么续费/后面到期了怎么续费/怎么更新
- 购买授权后,一年内可以更新源码,一年后源码可以一直用,授权是永久的。
- 继续订阅更新收取价格为3-4折,可以联系客服咨询
48. 价格可以少点吗/有优惠吗/有折扣吗/可以打折吗/便宜点/价格少点
价格是官网统一发布, 每个客户相同时间购买价都是一样的。一般没有其他优惠活动,具体参考 https://fastbee.cn/doc/sponsor/
49. 商业版价格是多少/商业版是多少钱/平台价格多少/价格/多少钱/授权费是多少/授权费用/想了解一下你们商用的是怎么定价的/怎么定价的/我想咨询一下 目前买商业版有哪些服务/商业版包含些什么服务/商业版包含些什么/商业行为有限制吗/商用价格多少/组态也是单独收费?/商业版可以支持二次开发和销售吧/二次销售/商用怎么购买服务?/怎么授权的?/费用是多少了?/授权是永久授权吗/可以获得合法授权吗
- 价格可以参考我们官网文档,都是统一发布的 https://fastbee.cn/doc/sponsor/
- 提供平台源码、可视化源码、移动端源码,可以私有化部署。
- 源码交付方式:提供私有仓库账号(git账号),账号是用来获取和更新源码的,可以部署和接入设备,编译部署的话限制部署10个项目,需要交付源码给客户的话限制部署项目数量1家。增加项目数量可以联系客服咨询。
- 购买后加入企业用户群交流,有问题随时沟通交流,提供必要技术支持。
- 提供发票/合同/授权证书(授权为合法授权且是永久授权),加入商业版私有仓库,赠送一年的订阅更新。
- 组态和音箱属于单独付费模块,不包含在商业版(旗舰版)里。
50. 定制开发费用/定制费用
- 定制开发费用1000-3000元/工作日
- 具体更具项目需求和难度来定
