Spring Boot远程连接Oracle数据库Windows正常Linux返回空集排查求助

• 时区配置差异验证
  Windows与Linux系统默认时区通常存在差异，若查询语句包含日期过滤条件、或业务逻辑依赖Oracle会话时区配置，会直接导致条件匹配失败返回空结果。可在Jar包启动时追加JVM参数强制固定时区，排除该类问题：

  java -Duser.timezone=Asia/Shanghai -jar your-app.jar
  

  也可在JDBC连接串中追加oracle.jdbc.timezoneAsRegion=false参数，禁用驱动根据系统时区自动调整会话时区的逻辑。
• Oracle NLS会话参数验证
  Oracle JDBC驱动会默认继承操作系统的语言、区域配置初始化会话NLS参数（如NLS_DATE_FORMAT、NLS_LANG、NLS_NUMERIC_CHARACTERS等）。若查询语句中使用to_date/to_char等函数未显式指定格式，不同环境的会话参数差异会导致条件匹配失败。
  可在代码执行业务查询前，先执行固定会话参数的语句统一配置，示例：

  ALTER SESSION SET NLS_DATE_FORMAT = 'YYYY-MM-DD HH24:MI:SS';
  ALTER SESSION SET NLS_LANGUAGE = 'SIMPLIFIED CHINESE';
  

  也可在启动时追加JVM参数固定系统区域配置：-Duser.language=zh -Duser.region=CN
• 运行环境变量干扰排查
  若Linux环境安装了Oracle客户端，JDBC驱动会自动读取ORACLE_HOME、TNS_ADMIN、NLS_LANG等系统环境变量，可能覆盖Jar包内的默认配置。可在启动Jar前先清空相关环境变量再运行，排除干扰：

  unset ORACLE_HOME TNS_ADMIN NLS_LANG
  java -jar your-app.jar
  

• 连接身份与实例验证
  Spring Boot会优先加载Jar包同目录、运行用户目录下的外部配置文件，可能出现Linux环境读取了外部配置、连接到同一数据库的其他用户/测试实例的情况。可在代码中追加日志，启动后打印以下查询的结果，和Windows环境的输出对比：

  -- 确认当前连接用户
  SELECT USER FROM DUAL;
  -- 确认当前连接的数据库实例
  SELECT INSTANCE_NAME, HOST_NAME FROM V$INSTANCE;
  -- 确认无过滤条件下的表数据量，判断是全表无返回还是带条件查询无返回
  SELECT COUNT(*) FROM 业务查询用的表名;
  

• 查询语句一致性验证
  开启JDBC SQL日志打印，确认Linux环境实际执行的SQL语句、传入的绑定参数和Windows环境完全一致。也可将日志中打印的SQL直接放到Linux环境的sqlplus中执行，若sqlplus执行有结果、代码执行无结果，可确定为会话参数类问题。

内容的提问来源于stack exchange，提问作者Giannis Ntelakis