ianhuang筆記THE ADVENTURER'S JOURNAL
知識世界・持續探索中

ADVENTURE JOURNAL · 探索筆記

Tomcat 設定:JNDI、環境變數與 JVM 引數

任務導覽 TABLE OF CONTENTS

保留 context.xml 的 JNDI 情境,說明它與 OS 環境及 Spring profile 的差異。

適用:Tomcat 9 的 javax 應用;Tomcat 10+ 改為 jakarta,遷移需核對應用與依賴。

JNDI 不是 OS 環境變數

應用專用設定可放 CATALINA_BASE/conf/Catalina/localhost/myapp.xml:

<?xml version="1.0" encoding="UTF-8"?>
<Context>
  <Environment name="ENV" value="uat" type="java.lang.String" override="false"/>
</Context>

應用以 new InitialContext().lookup("java:comp/env/ENV") 讀取,應為 uat;不能預期 System.getenv("ENV") 自動讀到此值。全域性 conf/context.xml 會影響多應用,應先判定設定範圍。

JVM 與 Spring profile

Unix shell 啟動用 CATALINA_BASE/bin/setenv.sh:

CATALINA_OPTS="-Xms256m -Xmx512m -Dspring.profiles.active=uat"
export CATALINA_OPTS

該檔案由Tomcat啟動指令碼讀取,不直接手動執行替代catalina。Windows指令碼以setenv.bat設定;Windows service使用服務包裝器的Java選項,可能不會讀取指令碼。JAVA_OPTS/CATALINA_OPTS也不是Java語言內建環境變數。

Spring Boot 某些設定來源可讀取JNDI,但依部署模式與版本而定;standalone jar 不在TomcatJNDI容器內。profile優先順序見 Spring profile 。

確認

重新啟動後通過應用輸出非敏感的ENV值或受控診斷確認,檢查真正的啟動命令/服務設定。不要在日誌列出所有環境秘密;JNDI名稱與大小寫一致。無法lookup時先核對應用context檔名、目錄與java:comp/env字首,再看啟動日誌。

參考資料

冒險者留言

comments powered by Disqus

搜尋筆記

輸入關鍵字,探索所有筆記。

ESC 關閉 · 搜尋標題、標籤與文章全文