Mybatis.NET Oracle 线上神奇问题：Value does not fall within the expected range.
1、错误现象
在向数据库查询一条数据的时候报如下错误：
1 Value does not fall within the expected range. 2 at Oracle.ManagedDataAccess.Client.OracleParameter.set_Value(Object value) 3 at MyBatis.DataMapper.Data.DefaultPreparedCommand.ApplyParameterMap(IDbProvider dbProvider, IDbCommand command, RequestScope request, IStatement statement, Object parameterObject) 4 at MyBatis.DataMapper.Data.DefaultPreparedCommand.Create(RequestScope request, ISession session, IStatement statement, Object parameterObject) 5 at MyBatis.DataMapper.MappedStatements.MappedStatement.Execute[T](Object preEvent, Object postEvent, ISession session, Object parameterObject, Func`3 requestRunner) 6 at MyBatis.DataMapper.MappedStatements.MappedStatement.ExecuteInsert(ISession session, Object parameterObject) 7 at MyBatis.DataMapper.DataMapper.Insert(String statementId, Object parameterObject)
错误信息也很简单。在向OracleParameter的属性Value赋值时报错。
2、找不出的错误原因
源码如下：
1 [Category("Data"), Description(""), DefaultValue((string) null)] 2 public override object Value 3 { 4 get => 5 this.m_value; 6 set 7 { 8 if (((value != null) && (value != DBNull.Value)) && (this.m_enumType == PrmEnumType.NOTSET)) 9 { 10 Type type = value.GetType(); 11 if (((type == typeof(sbyte)) || (type == typeof(ushort))) || ((type == typeof(uint)) || (type == typeof(ulong)))) 12 { 13 throw new ArgumentException(); 14 } 15 object obj2 = OraDb_DbTypeTable.s_table[type]; 16 if ((obj2 == null) && type.IsArray) 17 { 18 obj2 = OraDb_DbTypeTable.s_table[type.GetElementType()]; 19 } 20 if (obj2 == null) 21 { 22 throw new ArgumentException(); 23 } 24 this.m_oraDbType = (OracleDbType) obj2; 25 this.m_bSetDbType = false; 26 this.m_enumType = PrmEnumType.VALUE; 27 } 28 this.m_value = value; 29 } 30 } 31
从源码可以看到，报错可能出现在两个地方：if (((type == typeof(sbyte)) || (type == typeof(ushort))) || ((type == typeof(uint)) || (type == typeof(ulong))))【更老的驱动版本bool类型也不支持】 和 if (obj2 == null)。出现这个错误说明无法将C#类型映射为Oracle类型。
首先检查第一处可能，发现插入报错的类中使用的类型有DateTime,DateTime?,long,int,string。发现第一处不满足。
检查第二次可能，第二处取类型是从 OraDb_DbTypeTable 获取到的。源码如下：
1 internal static void InsertTableEntries() 2 { 3 s_table.Add(typeof(byte), OracleDbType.Byte); 4 s_table.Add(typeof(byte[]), OracleDbType.Raw); 5 s_table.Add(typeof(char), OracleDbType.Varchar2); 6 s_table.Add(typeof(char[]), OracleDbType.Varchar2); 7 s_table.Add(typeof(DateTime), OracleDbType.TimeStamp); 8 s_table.Add(typeof(short), OracleDbType.Int16); 9 s_table.Add(typeof(int), OracleDbType.Int32); 10 s_table.Add(typeof(long), OracleDbType.Int64); 11 s_table.Add(typeof(float), OracleDbType.Single); 12 s_table.Add(typeof(double), OracleDbType.Double); 13 s_table.Add(typeof(decimal), OracleDbType.Decimal); 14 s_table.Add(typeof(string), OracleDbType.Varchar2); 15 s_table.Add(typeof(TimeSpan), OracleDbType.IntervalDS); 16 s_table.Add(typeof(OracleBFile), OracleDbType.BFile); 17 s_table.Add(typeof(OracleBinary), OracleDbType.Raw); 18 s_table.Add(typeof(OracleBlob), OracleDbType.Blob); 19 s_table.Add(typeof(OracleClob), OracleDbType.Clob); 20 s_table.Add(typeof(OracleDate), OracleDbType.Date); 21 s_table.Add(typeof(OracleDecimal), OracleDbType.Decimal); 22 s_table.Add(typeof(OracleIntervalDS), OracleDbType.IntervalDS); 23 s_table.Add(typeof(OracleIntervalYM), OracleDbType.IntervalYM); 24 s_table.Add(typeof(OracleRefCursor), OracleDbType.RefCursor); 25 s_table.Add(typeof(OracleString), OracleDbType.Varchar2); 26 s_table.Add(typeof(OracleTimeStamp), OracleDbType.TimeStamp); 27 s_table.Add(typeof(OracleTimeStampLTZ), OracleDbType.TimeStampLTZ); 28 s_table.Add(typeof(OracleTimeStampTZ), OracleDbType.TimeStampTZ); 29 s_table.Add(typeof(OracleXmlType), OracleDbType.XmlType); 30 s_table.Add(typeof(bool), OracleDbType.Boolean); 31 s_table.Add(typeof(DateTimeOffset), OracleDbType.TimeStampTZ); 32 }
发现里面没有DateTime?，难道是这个地方不行。那也不对啊，其它地方同样类型是可以保存到数据库的啊。继续找下去在 MyBatis.DataMapper.Data.DefaultPreparedCommand.ApplyParameterMap 找到了信息。源码如下：
1 public virtual void SetParameter(IDataParameter dataParameter, object parameterValue, string dbType) 2 { 3 if (parameterValue != null) 4 { 5 dataParameter.Value = parameterValue; 6 } 7 else 8 { 9 dataParameter.Value = DBNull.Value; 10 } 11 }
如果值为null，会自动赋值为 DBNull.Value 也就会不会报错。既然都不会出现问题，可问题又会出现在哪里呢？
3、柳暗花明
在本地尝试各种方法后仍然不能重现，只能让领导将生产程序包拷贝一份下来进行尝试。
包拿到之后，进行必要配置启动，出现了新的诡异问题 Redis报错 ：No connection is available to service this operation。仔细检查Redis配置发现问题。抓下内存快照看看实际配置信息是什么：
看到这个一脸懵逼，Password竟然是null，明明已经配置了啊。查看了加载配置的源码，发现根本不会解析Password配置，还有这种操作，这程序包是有多老。弄好了Redis，启动保存数据，果然不行。反编译生产源码，发现惊天一幕：
Id的类型竟然ulong。我擦这是多久没有更新了。原因至此是找到了。
4、吐槽
这个服务是公司内部自己用的，很古老了。以前都是手工拷贝程序包发布的。最近由于公司发生了些意外事情，原来服务器不能用，需要部署新的服务器上。由于古老，不知道老大当时拿了多么古老的程序包部署了。
