env-entry-type 必须填写容器支持的标准类型，如java.lang.String、java.lang.Integer等，大小写和完整包名必须准确，否则导致JNDI查找失败或启动异常。
env-entry-type 在 web.xml 里到底填什么类型
填错 env-entry-type 会导致 JNDI 查找失败，或者应用启动时直接抛 javax.naming.NamingException。它不是随便写个类名就行，必须是容器能识别并自动转换的“标准类型”。
Web 容器（如 Tomcat、Jetty）只支持一小部分 Java 基础类型和少数包装类，且要求类名**完全匹配**，大小写、包路径都不能错。常见错误是写 java.lang.String 却漏了 java.lang. 前缀，或误用 String（不带包名）——这在大多数容器里会报 ClassNotFoundException。
-
java.lang.String（最常用，也是唯一允许为空值的类型） -
java.lang.Boolean/java.lang.Byte/java.lang.Short/java.lang.Integer/java.lang.Long/java.lang.Float/java.lang.Double -
java.lang.Character（注意：不是char，必须是包装类） -
java.math.BigDecimal和java.math.BigInteger（Tomcat 8+ 支持，旧版可能不认）
自定义类、数组、集合、泛型类型一律不支持 —— 别试，JNDI 不做反序列化，也不走 Spring 那套类型转换逻辑。
为什么 String 能存空值，其他类型不行
因为只有 java.lang.String 的转换逻辑里显式处理了 null 或空字符串；其他类型（比如 java.lang.Integer）在解析 env-entry-value 时会调用 valueOf()，传入空字符串直接抛 NumberFormatException。
典型错误现象：env-entry-value 写成空格或留空，env-entry-type 是 java.lang.Integer，启动时报：
java.lang.NumberFormatException: For input string: ""
解决办法只有两个：
- 确保
env-entry-value是合法非空字符串（如42） - 如果业务上真需要“未配置”语义，改用
java.lang.String，代码里自己判断是否为空再转
Tomcat 和 WildFly 对 env-entry-type 的兼容性差异
Tomcat（9.0+）严格按 Servlet 规范只认上面列出的标准类型；WildFly（基于 Jakarta EE）额外支持 java.time.LocalDate 等新时间类型，但前提是你的 web.xml 版本声明为 xmlns="https://jakarta.ee/xml/ns/jakartaee"，且部署在 Jakarta EE 9+ 环境中。
混用会导致静默失败：比如在 Tomcat 里配了 java.time.LocalDateTime，应用能启动，但 InitialContext.lookup("java:comp/env/mydate") 返回 null 或抛 NameNotFoundException，而不是类型错误 —— 因为容器压根没注册这个类型转换器。
- 跨容器迁移前，先检查
env-entry-type是否在目标容器的白名单里 - 不要依赖 IDE 自动补全的类名，手动核对容器文档（例如 Tomcat 10 的 JNDI Resources How-To）
- 若需复杂类型，改用
java.lang.String存 JSON，代码里解析 —— 更可控，也规避容器差异
env-entry-value 中的空白字符会被 trim 吗
会，但仅限首尾空白，且只对 java.lang.String 生效。其他类型（如 Integer）在调用 valueOf() 前，容器会先 trim 字符串 —— 所以 <env-entry-value> 123 </env-entry-value> 没问题，但 <env-entry-value>12 3</env-entry-value>（中间有空格）会失败。
容易被忽略的是换行：XML 中换行符会被解析为实际字符，导致 env-entry-value 实际值变成 "\n123\n"，trim 后是 "123"，没问题；但如果类型是 Character，"\n" 就会变成换行符本身，而非你预期的字母。
- 避免在
env-entry-value里写多行或缩进，保持单行紧凑格式 - 调试时可用
System.out.println("[" + value + "]")打印实际内容，确认边界字符 - 敏感字段（如密码、密钥）别用
env-entry传 —— 它明文写在 XML 里，且无法动态刷新
