ThingsBoard 3.5.1 社区版安装避坑实录：从下载到登录，我踩过的那些‘坑’都帮你填平了

ThingsBoard 3.5.1 社区版安装实战：避坑指南与深度优化

作为一名长期从事物联网平台部署的技术顾问，我见证了无数团队在ThingsBoard安装环节折戟沉沙。本文将分享我在Windows环境下部署ThingsBoard 3.5.1社区版时积累的实战经验，不仅涵盖常见问题的解决方案，更包含官方文档未提及的性能优化技巧。

1. 环境准备：那些容易被忽视的细节

1.1 Java环境配置的隐藏陷阱

OpenJDK 11的安装看似简单，但版本选择直接影响后续稳定性。推荐使用Eclipse Temurin JDK 11（原AdoptOpenJDK），其Windows安装包已通过ThingsBoard的完整测试。安装时需特别注意：

• 路径规范：即使保持默认路径，也要记录完整安装路径（如C:\Program Files\Eclipse Adoptium\jdk-11.0.15+10）
• 环境变量验证：执行以下命令确保配置正确：

  java -version
  echo %JAVA_HOME%
  

  若返回空白，需手动添加系统变量：

  变量名：JAVA_HOME
  变量值：C:\Program Files\Eclipse Adoptium\jdk-11.0.15+10
  

1.2 PostgreSQL的非常规配置要点

官方文档要求PostgreSQL 11.7+，但实际测试发现12.x版本兼容性更好。安装时有两个关键操作：

1. 服务端口冲突预防：安装向导中修改默认端口5432为5433，避免与已有实例冲突
2. 密码复杂度平衡：虽然文档建议使用postgres，但生产环境应设置8位以上包含大小写的密码，并在配置文件中相应调整