Heroku 的文件系统是只读且瞬态的，无法使用本地绝对路径（如 ./src/main/java/...）创建文件；必须动态指定可写临时目录（如 $HOME/tmp），并确保目录存在、权限正确。
heroku 的文件系统是只读且瞬态的，无法使用本地绝对路径（如 `./src/main/java/...`）创建文件；必须动态指定可写临时目录（如 `$home/tmp`），并确保目录存在、权限正确。
在 Heroku 上部署 Java Web 应用时，常见的误区是沿用本地开发中的硬编码路径（例如 ./src/main/java/org/test/resources/temp_allproducts.json）。该路径在本地可能因 IDE 工作目录或 Maven 构建结构而“恰好”可用，但在 Heroku 的运行环境中：
- 应用以标准 JAR/WAR 方式运行，源码目录（src/）根本不会被部署；
- 文件系统为只读根目录，仅 $HOME 及其子目录（如 $HOME/tmp）可写；
- 每次 dyno 启动都会重建文件系统，所有写入内容在 dyno 重启后即丢失（符合 Heroku 的无状态设计原则）。
✅ 正确做法：使用环境变量定义可写临时目录，并主动创建目录结构：
// 推荐：通过环境变量配置临时目录（如在 Heroku Dashboard 或 CLI 中设置）
private static final String TEMP_DIR_PATH = System.getenv("TEMP_DIR") != null
? System.getenv("TEMP_DIR")
: System.getProperty("user.home") + "/tmp";
private static File makeTempFile(String data, String fileName) {
File dir = new File(TEMP_DIR_PATH);
// 确保临时目录存在且可写
if (!dir.exists() && !dir.mkdirs()) {
throw new IllegalStateException("Failed to create temp directory: " + dir.getAbsolutePath());
}
// 使用 File(dir, name) 构造，避免路径拼接错误
File file = new File(dir, "temp_" + fileName + ".json");
try (FileWriter writer = new FileWriter(file)) {
writer.write(formatJson(data));
System.out.println("Created temp file: " + file.getAbsolutePath());
return file;
} catch (IOException e) {
throw new RuntimeException("Failed to write temp file: " + file.getAbsolutePath(), e);
}
}? Heroku 配置建议：
- 在 Heroku 设置中添加环境变量：
heroku config:set TEMP_DIR="$HOME/tmp"
- （可选）在应用启动时预创建目录（增强健壮性）：
static { new File(System.getenv("TEMP_DIR")).mkdirs(); }
⚠️ 重要注意事项：
立即学习“Java免费学习笔记（深入）”；
- ❌ 不要依赖 File.createTempFile() 返回的默认路径（它可能指向只读 /tmp，Heroku 中该路径受限）；
- ❌ 避免相对路径（如 "./temp.json"），其解析依赖当前工作目录，而 Heroku 的 user.dir 不可控；
- ✅ 始终检查 File.mkdirs() 返回值，并记录失败原因；
- ✅ 临时文件应在使用后显式删除（file.delete()），但注意：Heroku 的 $HOME/tmp 在 dyno 重启时自动清空，无需长期清理。
总结：Heroku 要求显式、可配置、可验证的临时路径策略。将路径逻辑与环境解耦，不仅解决部署问题，也提升了应用的可移植性与可观测性。
