合同纠纷的诉讼时效最长为三年，但在特定情况下可能延长至二十年。以下是详细解释：
一、一般情况下的诉讼时效
根据《中华人民共和国民法典》第一百八十八条的规定，向人民法院请求保护民事权利的诉讼时效期间为三年。这意味着，在一般情况下，如果合同一方认为自己的权益受到侵害，他需要在知道或应当知道权益受损之日起三年内提起诉讼，否则可能会丧失胜诉权。
二、特殊情况下的诉讼时效
最长保护期限：虽然一般诉讼时效为三年，但法律也规定了最长保护期限，即自权利受到损害之日起超过二十年的，人民法院不予保护。这意味着，如果合同纠纷的发生时间已经超过二十年，即使权利人在此期间内不知道自己的权益受到损害，也无法再通过法律途径来维护自己的权益。
诉讼时效的中断与中止：在诉讼时效期间内，如果发生某些法定事由，如权利人向义务人提出履行请求、义务人同意履行义务等，诉讼时效可以中断，并重新计算。此外，如果因不可抗力或其他障碍不能行使请求权，诉讼时效可以中止，待障碍消除后继续计算。这些规定为权利人提供了更多的保护机会。
三、实际应用中的注意事项
及时主张权利：为了避免因诉讼时效过期而丧失胜诉权，合同双方应在发现权益受损后及时主张权利，并考虑提起诉讼或采取其他法律措施。
保留证据：在合同纠纷中，证据的保留至关重要。权利人应妥善保管与合同相关的所有文件和记录，以便在需要时提供证明。
咨询专业律师：虽然我已经为你提供了基本的法律解释，但合同纠纷往往涉及复杂的法律问题和事实认定。因此，在处理具体案件时，建议你咨询专业律师以获取更具体的法律建议。
四、举例说明
假设甲与乙签订了一份买卖合同，约定乙在收到货物后支付货款。然而，乙在收到货物后一直未支付货款。如果甲在知道乙未支付货款之日起三年内未提起诉讼，且没有发生诉讼时效中断或中止的情形，那么甲可能会因诉讼时效过期而丧失胜诉权。但如果甲在知道权益受损后及时提起了诉讼，或者发生了诉讼时效中断或中止的情形，那么甲仍然有机会通过法律途径来维护自己的权益。
综上所述，合同纠纷的诉讼时效最长为三年，但在特定情况下可能延长至二十年。在处理合同纠纷时，建议你及时主张权利、保留证据，并在需要时咨询专业律师。如果你有任何具体的法律问题或需要进一步的法律建议，请直接向我咨询。