Mybatis.NET Oracle 线上神奇问题：Value does not fall within the expected range.

1、错误现象

　　在向数据库查询一条数据的时候报如下错误：

   Value does not fall within the expected range.
   at Oracle.ManagedDataAccess.Client.OracleParameter.set_Value(Object value)
   at MyBatis.DataMapper.Data.DefaultPreparedCommand.ApplyParameterMap(IDbProvider dbProvider, IDbCommand command, RequestScope request, IStatement statement, Object parameterObject)
   at MyBatis.DataMapper.Data.DefaultPreparedCommand.Create(RequestScope request, ISession session, IStatement statement, Object parameterObject)
   at MyBatis.DataMapper.MappedStatements.MappedStatement.Execute[T](Object preEvent, Object postEvent, ISession session, Object parameterObject, Func`3 requestRunner)
   at MyBatis.DataMapper.MappedStatements.MappedStatement.ExecuteInsert(ISession session, Object parameterObject)
   at MyBatis.DataMapper.DataMapper.Insert(String statementId, Object parameterObject)

　错误信息也很简单。在向OracleParameter的属性Value赋值时报错。

2、找不出的错误原因

　　源码如下：

　　

[Category("Data"), Description(""), DefaultValue((string) null)]
public override object Value
{
    get => 
        this.m_value;
    set
    {
        if (((value != null) && (value != DBNull.Value)) && (this.m_enumType == PrmEnumType.NOTSET))
        {
            Type type = value.GetType();
            if (((type == typeof(sbyte)) || (type == typeof(ushort))) || ((type == typeof(uint)) || (type == typeof(ulong))))
            {
                throw new ArgumentException();
            }
            object obj2 = OraDb_DbTypeTable.s_table[type];
            if ((obj2 == null) && type.IsArray)
            {
                obj2 = OraDb_DbTypeTable.s_table[type.GetElementType()];
            }
            if (obj2 == null)
            {
                throw new ArgumentException();
            }
            this.m_oraDbType = (OracleDbType) obj2;
            this.m_bSetDbType = false;
            this.m_enumType = PrmEnumType.VALUE;
        }
        this.m_value = value;
    }
}
 

　　从源码可以看到，报错可能出现在两个地方：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 获取到的。源码如下：

　　

internal static void InsertTableEntries()
{
    s_table.Add(typeof(byte), OracleDbType.Byte);
    s_table.Add(typeof(byte[]), OracleDbType.Raw);
    s_table.Add(typeof(char), OracleDbType.Varchar2);
    s_table.Add(typeof(char[]), OracleDbType.Varchar2);
    s_table.Add(typeof(DateTime), OracleDbType.TimeStamp);
    s_table.Add(typeof(short), OracleDbType.Int16);
    s_table.Add(typeof(int), OracleDbType.Int32);
    s_table.Add(typeof(long), OracleDbType.Int64);
    s_table.Add(typeof(float), OracleDbType.Single);
    s_table.Add(typeof(double), OracleDbType.Double);
    s_table.Add(typeof(decimal), OracleDbType.Decimal);
    s_table.Add(typeof(string), OracleDbType.Varchar2);
    s_table.Add(typeof(TimeSpan), OracleDbType.IntervalDS);
    s_table.Add(typeof(OracleBFile), OracleDbType.BFile);
    s_table.Add(typeof(OracleBinary), OracleDbType.Raw);
    s_table.Add(typeof(OracleBlob), OracleDbType.Blob);
    s_table.Add(typeof(OracleClob), OracleDbType.Clob);
    s_table.Add(typeof(OracleDate), OracleDbType.Date);
    s_table.Add(typeof(OracleDecimal), OracleDbType.Decimal);
    s_table.Add(typeof(OracleIntervalDS), OracleDbType.IntervalDS);
    s_table.Add(typeof(OracleIntervalYM), OracleDbType.IntervalYM);
    s_table.Add(typeof(OracleRefCursor), OracleDbType.RefCursor);
    s_table.Add(typeof(OracleString), OracleDbType.Varchar2);
    s_table.Add(typeof(OracleTimeStamp), OracleDbType.TimeStamp);
    s_table.Add(typeof(OracleTimeStampLTZ), OracleDbType.TimeStampLTZ);
    s_table.Add(typeof(OracleTimeStampTZ), OracleDbType.TimeStampTZ);
    s_table.Add(typeof(OracleXmlType), OracleDbType.XmlType);
    s_table.Add(typeof(bool), OracleDbType.Boolean);
    s_table.Add(typeof(DateTimeOffset), OracleDbType.TimeStampTZ);
}

　　发现里面没有DateTime?，难道是这个地方不行。那也不对啊，其它地方同样类型是可以保存到数据库的啊。继续找下去在 MyBatis.DataMapper.Data.DefaultPreparedCommand.ApplyParameterMap 找到了信息。源码如下：

　　

public virtual void SetParameter(IDataParameter dataParameter, object parameterValue, string dbType)
{
    if (parameterValue != null)
    {
        dataParameter.Value = parameterValue;
    }
    else
    {
        dataParameter.Value = DBNull.Value;
    }
}

　　如果值为null，会自动赋值为 DBNull.Value 也就会不会报错。既然都不会出现问题，可问题又会出现在哪里呢？

3、柳暗花明

　　在本地尝试各种方法后仍然不能重现，只能让领导将生产程序包拷贝一份下来进行尝试。

　　包拿到之后，进行必要配置启动，出现了新的诡异问题 Redis报错 ：No connection is available to service this operation。仔细检查Redis配置发现问题。抓下内存快照看看实际配置信息是什么：

　　

 　　看到这个一脸懵逼，Password竟然是null，明明已经配置了啊。查看了加载配置的源码，发现根本不会解析Password配置，还有这种操作，这程序包是有多老。弄好了Redis，启动保存数据，果然不行。反编译生产源码，发现惊天一幕：

　　

 　　Id的类型竟然ulong。我擦这是多久没有更新了。原因至此是找到了。

4、吐槽

　　这个服务是公司内部自己用的，很古老了。以前都是手工拷贝程序包发布的。最近由于公司发生了些意外事情，原来服务器不能用，需要部署新的服务器上。由于古老，不知道老大当时拿了多么古老的程序包部署了。