thingsboard常见编译报错解决

原创于 2025-12-27 09:21:40 发布 · 982 阅读

本内容遵循CC 4.0 BY-SA版权协议

一：Failed to execute goal org.thingsboard:gradle-maven-plugin:1.0.12:invoke

Maven构建失败，主要原因是无法从网络下载Gradle 7.3.3压缩包，国内网络连接问题访问异常。
1. 详细原因分析
Gradle下载失败：Maven插件无法从https://services.gradle.org/distributions/gradle-7.3.3-bin.zip下载Gradle压缩包

2.手动下载，把下载下来的文件放入这个C:\Users\Administrator\.gradle\wrapper\dists\gradle-7.3.3-bin文件夹下

二：前端构建失败，pkg工具执行出错 Failed to execute goal com.github.eirslett:frontend-maven-plugin:1.12.0:yarn (yarn pkg) on project web-ui: Failed to run task: 'yarn run pkg' failed. org.apache.commons.exec.ExecuteException: Process exited with an error: 2

原因：本地缓存缺少fetched-vv22.17.1-linux-x64和fetched-v1v22.17.1-win-x64这两个文件
解决方法：前往github下载对应文件并重命名，下载地址：https://github.com/zeit/pkg-fetch/releases

这个链接选择对应版本进行下载Releases · yao-pkg/pkg-fetch

下载之后放入这个位置，重命名为fetched-v22.17.1-linux-x64和fetched-v22.17.1-win-x64然后重新编译

注：如果不行就选择对应的版本从对应的地址下载

注：https://github.com/yao-pkg/pkg-fetch/releases/download/v3.5/node-v22.17.1-win-x64

三、license问题

Failed to execute goal com.mycila:license-maven-plugin:3.0:check (default) on project cache: Some files do not have the expected license header

原因：添加的本地文件缺少头部license
解决方法：在你新增的文件里面的头部增加默认的license

/**
 * Copyright © 2016-2025 The Thingsboard Authors
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */