为何设置TZ环境变量后Heroku日志仍显示UTC时间戳？

哥们，我太懂你这个困扰了——之前我也折腾过好久，明明给dyno设了TZ环境变量，结果Heroku日志的时间戳还是顽固地显示UTC。其实这是Heroku平台的一个设计点，咱得搞清楚原因再解决：

核心原因 #

你设置的TZ环境变量是给你的应用dyno内部用的，比如你的应用代码里生成的时间、定时任务的时间都会遵循这个时区。但Heroku日志里的那个前缀时间戳，是Heroku的路由层和日志系统生成的，它属于平台级的记录，默认就固定用UTC，和dyno的时区设置完全没关系。

解决方法 #

1. 让应用自己输出带正确时区的日志

与其依赖Heroku的平台时间戳，不如在你的应用代码里直接输出包含时区的完整日志内容。这样不管Heroku平台怎么显示前缀，你自己的日志信息里的时间都是正确的。
举个例子：

• Python里，你可以这样格式化日志：

  import os
  import pytz
  from datetime import datetime
  
  tz = pytz.timezone(os.getenv('TZ', 'UTC'))
  current_time = datetime.now(tz).strftime('%Y-%m-%d %H:%M:%S %Z')
  print(f"[{current_time}] 应用日志内容...")
  

• Node.js里：

  const tz = process.env.TZ || 'UTC';
  const currentTime = new Date().toLocaleString('en-US', { timeZone: tz });
  console.log(`[${currentTime}] 应用日志内容...`);
  

2. 本地转换日志时间戳

如果你不想改代码，只想在本地查看日志时看到对应时区的时间，可以用命令行工具把UTC时间转换成你需要的时区。比如：

• 用date命令配合awk处理Heroku的ISO8601格式时间戳：

  heroku logs --tail | awk '{
      cmd = "date -d \"" $1 "\" +\"%Y-%m-%d %H:%M:%S %Z\""
      cmd | getline new_time
      close(cmd)
      $1 = new_time
      print
  }'
  

  要是想指定特定时区，还可以给date命令加时区参数，比如：

  heroku logs --tail | awk '{
      cmd = "date -d \"" $1 "\" +\"%Y-%m-%d %H:%M:%S %Z\" TZ=\"America/New_York\""
      cmd | getline new_time
      close(cmd)
      $1 = new_time
      print
  }'
  

3. 使用日志聚合工具

如果你的应用需要长期存储和查看日志，可以用Heroku的日志插件（比如Papertrail、Logentries），这些工具大多支持在后台将UTC时间自动转换成你指定的时区，在控制台直接显示正确的时间，不用自己折腾命令行或代码。

总结 #

记住：TZ变量只影响dyno内部的时间，Heroku平台的日志时间戳是独立的。要么让应用自己输出正确时区的日志，要么在本地/日志工具里转换时间，就能解决这个问题啦。

内容的提问来源于stack exchange，提问作者Douglas Reid