Skip to main content
Version: 4.6.1-saas

Troubleshooting

Common issues, solutions, and frequently asked questions for NetFUNNEL React Native Agent integration.

Installation Issues​

Package Installation Failure​

Symptoms:

  • npm install fails
  • Package not found

Solutions:

  1. Check network connection: Verify internet connection status
  2. Check package path: Verify that the dependency path in package.json is correct
  3. Clear npm cache: Run npm cache clean --force and retry

Initialization Failure​

Symptoms:

  • Error occurs when app starts
  • NetFUNNEL is not initialized

Solutions:

  1. Check clientId: Verify that clientId is set correctly
  2. Check empty string: Verify that clientId is not an empty string
  3. Initialization location: Verify that initialization is done at the start of App.js or App.tsx

Function Call Errors​

"nfStart is not a function" Error​

Symptoms:

  • ReferenceError: nfStart is not defined
  • Function is undefined when called

Solutions:

  1. Check initialization: Verify that Netfunnel.initialize() was called first
  2. Check import: Verify that import Netfunnel from 'netfunnel-rn-agent' is correct
  3. Function usage: Verify that it is called in the format Netfunnel.nfStart()

Callback Not Executing​

Symptoms:

  • nfStart is called but callback is not executed
  • No response received

Solutions:

  1. Check network: Verify network requests to NetFUNNEL server
  2. Console logs: Set printLog: true to check debugging logs
  3. Segment status: Verify that the segment is not in Block status
  4. Limited Inflow: Verify that Limited Inflow allows entry

Network and Connection Issues​

Network Timeout Error​

Symptoms:

  • NetworkError status code 1002
  • Request times out

Solutions:

  1. Increase timeout: Set networkTimeout to a higher value (max 10000ms)
  2. Configure retry: Increase retryCount
  3. Network recovery: Enable useNetworkRecoveryMode: true
Netfunnel.initialize({
  clientId: 'your-client-id',
  networkTimeout: 5000,
  retryCount: 2,
  useNetworkRecoveryMode: true
});

Network Connection Error​

Symptoms:

  • NetworkError status code 1001
  • No internet connection

Solutions:

  1. Check connection: Verify internet connection status
  2. Firewall: Verify that NetFUNNEL domain is not blocked
  3. Proxy settings: Configure proxy if necessary
  4. Error handling: Implement appropriate NetworkError handling
function nfCallback(response) {
  if (response.status === 'NetworkError') {
    // Display user-friendly message
    Alert.alert('Network Connection Issue', 'Please check your internet connection.');
    // Optionally retry or continue
  }
}

Waiting Room Issues​

Waiting Room Not Displayed​

Symptoms:

  • Waiting room does not appear
  • User proceeds directly

Solutions:

  1. Limited Inflow: Set to 0 for testing
  2. Segment activation: Verify that the segment is activated
  3. Template settings: Verify useNetfunnelTemplate: true
  4. WebView component: Verify that <Netfunnel.WebViewComponent /> is added correctly

Waiting Room Stuck (Does Not End)​

Symptoms:

  • Waiting room appears but entry is not allowed
  • Infinite waiting

Solutions:

  1. Limited Inflow: Increase Limited Inflow value
  2. Segment status: Verify that the segment is in Block status
  3. Network issues: Verify network connection status
  4. Server status: Verify NetFUNNEL server status

Key Management Issues​

Key Not Returned​

Symptoms:

  • Next user waits indefinitely
  • Queue does not progress

Solutions:

  1. nfStop call: Always verify that nfStop/nfStopSection is called
  2. Error handling: Return key even in error scenarios
  3. Check timeout: Verify segment timeout settings
try {
  await performAction();
  Netfunnel.nfStop(projectKey, segmentKey);
} catch (error) {
  console.error('Operation failed:', error);
  // Return key even on error
  Netfunnel.nfStop(projectKey, segmentKey);
}

Debugging Tips​

Check Logs​

You can check logs by setting printLog: true for debugging:

Netfunnel.initialize({
  clientId: 'your-client-id',
  printLog: true  // Enable debugging logs
});

Check logs with [NF4] prefix in the console.

Common Checkpoints​

  1. Check initialization: Verify that Netfunnel.initialize() is called correctly
  2. WebView component: Verify that <Netfunnel.WebViewComponent /> is added in the correct location
  3. Key matching: Verify that the same keys are used in start and stop functions
  4. Callback implementation: Verify that required statuses (Success, Error, NetworkError) are handled