Phoenix Framework环境变量配置路由及Telegram机器人Webhook发布问题

1. 如何在Phoenix Framework中用环境变量配置路由？ #

在Phoenix里配置带环境变量的路由，核心要记住：Phoenix路由是编译期确定的，所以得保证编译时能拿到有效的配置值。我常用两种靠谱的实现方式：

方式一：通过应用配置中转（首推） #

这种方式把配置集中管理，还能设置默认值，避免环境变量未配置时出错：

1. 先在配置文件（比如config/config.exs或对应环境的prod.exs）中，将环境变量映射为应用配置：

# config/config.exs
config :your_app, :custom_route_path, System.get_env("CUSTOM_ROUTE_PATH") || "/default-webhook"

2. 然后在lib/your_app_web/router.ex中读取这个配置：

scope "/api", YourAppWeb do
  pipe_through :api
  post "/#{Application.get_env(:your_app, :custom_route_path)}", YourController, :handle_webhook
end

方式二：直接在路由中读取环境变量 #

如果项目结构简单，也可以直接在路由里调用System.get_env/1，但不推荐复杂项目使用（配置分散，不好维护）：

scope "/api", YourAppWeb do
  pipe_through :api
  post "/#{System.get_env("CUSTOM_ROUTE_PATH") || "/default-webhook"}", YourController, :handle_webhook
end

2. Distillery构建后Webhook路由的问题排查 #

你提到用Distillery打包发布后遇到问题，虽然没说明具体错误，但结合你的代码实现（prod.secret.exs用${WEBHOOK}占位、路由读取应用配置），我整理了几个常见的排查方向和解决思路：

排查点1：环境变量是否正确加载 #

Distillery对环境变量的处理依赖版本：

• 如果你用的是Distillery 2.x+，${WEBHOOK}这种插值语法默认支持，但要确保运行发布包时WEBHOOK变量确实存在（可以先执行echo $WEBHOOK验证）
• 旧版本Distillery可能需要额外配置才能解析${VAR}占位符
• 注意：如果在启动脚本中设置变量，必须用export WEBHOOK=xxx，否则变量无法传递到应用进程

排查点2：路由编译时机的坑 #

Phoenix路由是编译时生成的！如果构建时未设置WEBHOOK环境变量，配置里的${WEBHOOK}不会被替换，路由会直接把/api/${WEBHOOK}当成有效路径，自然无法匹配请求。

解决办法有两种：

• 要么构建时就设置WEBHOOK变量，让配置在编译阶段完成插值
• 要么改用运行时动态匹配路由（适合需要动态调整Webhook路径的场景），用Plug通配符匹配后在控制器验证路径：

# 替换原有的post路由
match "/api/*path", to: TwitterController, :index, via: [:post]

# 在TwitterController中添加路径验证逻辑
def index(conn, %{"path" => path}) do
  expected_webhook_path = Application.get_env(:tweet_bot, :webhook)
  if path == expected_webhook_path do
    # 正常处理Webhook请求
    conn |> send_resp(200, "OK")
  else
    # 路径不匹配返回404
    conn |> send_resp(404, "Not Found")
  end
end

这种方式的优势是路径在运行时读取，不受编译期限制，特别适合Webhook这种需要保密、可能动态调整的场景。

排查点3：prod.secret.exs的加载顺序 #

要确保prod.secret.exs在prod.exs之后加载，否则如果prod.exs中有覆盖webhook配置的内容，你的环境变量配置会失效。检查config/prod.exs末尾是否有这句：

import_config "prod.secret.exs"

排查点4：Distillery的配置模板设置 #

如果你的prod.secret.exs作为模板使用，需要在rel/config.exs中配置Distillery在启动时重新加载配置，替换环境变量占位符：

# rel/config.exs
release :tweet_bot do
  set version: current_version(:tweet_bot)
  set applications: [:runtime_tools]
  # 启用配置模板替换
  set config_providers: [
    {Distillery.Config.Providers.Elixir, ["${RELEASE_ROOT_DIR}/config/prod.secret.exs"]}
  ]
end

这样Distillery启动时会重新解析配置中的${WEBHOOK}，替换为实际的环境变量值。

内容的提问来源于stack exchange，提问作者Sam Chen