应关注路径分隔符、换行符、文件权限等底层行为而非os.name；配置文件需分层加载并避免硬编码路径；容器中须显式设置时区；数据库连接host不可写localhost，且注意jdbc ssl配置。
用 System.getProperty("os.name") 判断系统类型不靠谱
很多人直接靠这个判断 Windows/Linux，但问题在于：本地开发可能是 Windows + WSL，服务器是 CentOS，而 System.getProperty("os.name") 在 WSL 下仍返回 "Linux"，实际却跑在 Windows 文件系统上。更麻烦的是，Docker 容器里也可能伪装成任意 OS 名。
真正该关注的不是“系统名”，而是「路径分隔符」「换行符」「文件权限行为」这些底层表现：
-
File.separator或Path.of(...)（推荐）自动适配分隔符，别硬写"\"或"/" - 读写文本时显式指定
StandardCharsets.UTF_8，避免服务器默认编码是 ISO-8859-1 导致中文乱码 - 用
Files.isExecutable(path)替代file.canExecute()，后者在某些 Docker 镜像中始终返回false
配置文件路径优先走 classpath: + 外部 --spring.config.location
Spring Boot 项目常犯的错：把配置文件硬编码成 new File("config/application.yml")，结果本地能跑，服务器因工作目录不同直接 FileNotFoundException。
正确做法是分层加载：
立即学习“Java免费学习笔记（深入）”；
- 基础配置放
src/main/resources/application.yml（打包进 jar） - 环境差异化配置放外部路径，如服务器上启动时加参数：
java -jar app.jar --spring.config.location=file:/etc/myapp/config/
- Java 代码里读取配置统一用
@Value("${xxx}")或Environment，别自己FileInputStream打开
LocalDateTime.now() 在容器里可能不准
Docker 默认不共享宿主机时区，LocalDateTime.now() 看似无害，但背后依赖 JVM 的默认时区。本地开发机时区是 Asia/Shanghai，服务器容器若没设 TZ=Asia/Shanghai，JVM 会 fallback 到 GMT，导致日志时间、定时任务全错位。
解决方案必须双管齐下：
- 构建镜像时在
Dockerfile加：ENV TZ=Asia/Shanghai<br>RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
- Java 启动参数强制指定：
-Duser.timezone=Asia/Shanghai
- 业务代码中避免裸用
LocalDateTime.now()，改用ZonedDateTime.now(ZoneId.of("Asia/Shanghai"))显式声明时区
数据库连接 URL 的 host 别写 localhost
本地用 H2 或本机 MySQL，URL 写 jdbc:mysql://localhost:3306/db 没问题；但一上服务器，MySQL 很可能在独立容器或 RDS 上，localhost 在容器内解析为自身 loopback，连不上外部 DB。
必须改成可配置的 host 名：
- Spring Boot 中用占位符：
spring.datasource.url=jdbc:mysql://${DB_HOST:localhost}:3306/db - 服务器部署时通过环境变量注入：
DB_HOST=mysql-prod.internal
- 本地开发用
application-local.yml覆盖：DB_HOST: 127.0.0.1
（注意这里用127.0.0.1而非localhost，绕过 Unix socket 连接逻辑）
最容易被忽略的一点：MySQL JDBC 驱动 8.0+ 默认启用 useSSL=true，而自签名证书或 RDS 的 SSL 配置不一致时，本地连得通，服务器报 SSLHandshakeException —— 记得检查 useSSL 和 allowPublicKeyRetrieval 参数是否对齐。
