When encountering the error message runtime error: /etc/haproxy/route_req.lua:3: attempt to call a nil value (method 'fhdr'), it typically suggests that there is an issue with accessing or utilizing the fhdr method from the Lua script integrated with HAProxy. This can happen due to a variety of reasons ranging from configuration errors, compatibility issues between the Lua API and the HAProxy version, or simple programming errors. Here’s a detailed explanation and guide on diagnosing and resolving this issue.

Understanding the Context

HAProxy is a popular open-source software that provides a high availability load balancer and proxy server for TCP and HTTP-based applications. It is particularly noted for its high performance and stability, features a robust configuration language, and also supports Lua scripting.

Lua scripting in HAProxy allows for advanced routing decisions, traffic manipulation, and more. This feature leverages Lua's lightweight and powerful programming capabilities integrated within the HAProxy runtime environment.

Technical Breakdown of the Error

The error message essentially breaks down into several parts:

• "attempt to call a nil value (method 'fhdr')" suggests that when the Lua script attempted to call the method fhdr, it either wasn't available (nil) or wasn't recognized as a method.
• Error occurring at /etc/haproxy/route_req.lua:3 indicates that this incident occurs at line 3 of the specified Lua script file.

Possible Causes

1. HAProxy Version Compatibility: If the HAProxy version in use does not support the fhdr method, or if there have been changes in the API, it could lead to this error.
2. Improper API usage: Misuse of the method, such as incorrect parameters or calling context.
3. Lua Script Errors: There might be errors in the script, such as misconfiguration or syntax issues.

Example Scenario and Solution

Suppose the faulty script, route_req.lua, looks something like this:

1core.register_service("routeIP", "http", function(applet)
2    local hdr_value = applet.fhdr("X-Client-IP")
3    -- additional processing
4end)

In this script, the call to applet.fhdr("X-Client-IP") is supposed to fetch the X-Client-IP header from the incoming HTTP request. However, due to the error, it's clear that fhdr is not recognized.

Solution Approach

Check HAProxy Documentation

Verify that the HAProxy version you use supports the fhdr function as part of the applet's methods. The function prototypes or API might have changed across different versions of HAProxy. Checking the official HAProxy documentation relative to your version would be beneficial.

Correct Lua Script

Ensure that method calls to fhdr are appropriate and check for any typos or syntax issues. Modify the script as follows if the method has been renamed or changed:

1core.register_service("routeIP", "http", function(applet)
2    local hdr_value = applet.fetch_http_header("X-Client-IP")
3    -- additional processing
4end)

HAProxy Configuration

Make sure that your HAProxy configuration file correctly refers to Lua scripts and is designed to handle HTTP requests properly, delegating to Lua for specific routes or purposes.

Summary Table

Conclusion

By systematically reviewing the HAProxy version, Lua script implementation, and HAProxy configuration, you can resolve issues related to the attempt to call a nil value error. Ensuring compatibility and correctness in these areas will ensure smooth integration of Lua scripts within your HAProxy setup.